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原文 : Introduction 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


Matplotlib 是 一 个 用 于 在 Python 中 绘制 数组 的 2D 图 形 库 。 虽 然 它 起 源 于 模仿 
MATLAB@[1] 图 形 命令 ， 但 它 独立 于 MATLAB， 可 以 以 Pythonic 和 面向 对 象 的 方 
式 使 用 。 虽 然 Matplotlib 主要 是 在 纯 Python 中 编写 的 ， 但 它 大 量 使 用 NumPy 和 其 
他 扩展 代码 ， 即 使 对 于 大 型 数组 也 能 提供 良好 的 性 能 。 


Matplotlib 的 设计 理念 是 ， 你 应 该 能 够 使 用 几 个 ， 或 者 只 有 一 个 命令 创建 简单 的 图 
形 。 如 果 你 想 看 到 你 的 数据 的 直方 图 ， 你 不 需要 实例 化 对 象 ， 调 用 方法 ， 设 置 属性 
等 等 ; 它 应 该 能 够 工作 。 

多 年 来 ， 我 常常 使 用 MATLAB 进行 数据 分 析 和 可 视 化 。 MATLAB 擅长 绘制 漂亮 的 
图 形 。 当 我 开始 处 理 EEG 数据 时 ， 我 发 现 我 需要 编写 应 用 程 友 来 与 我 的 数据 交 
互 ， 并 在 MATLAB 中 开发 了 一 个 EEG 分 析 应 用 程序 。 随 着 应 用 程序 越 来 越 复杂 ， 
需要 与 数据 库 ，http 服务 器 交互 ， 并 操作 复杂 的 数据 结构 ， 我 开始 与 MATLAB 作 
为 一 种 编程 语言 的 限制 而 抗争 ， 并 决定 迁移 到 Python。 Python 作为 一 种 编程 语 
言 ， 弥 补 了 MATLAB 的 所 有 缺陷 ， 但 我 很 难 找到 一 个 2D 绘图 包 (3D VTK 则 超过 
了 我 的 所 有 需求 ) 。 


当 我 去 寻找 一 个 Python 绘图 包 时 ， 我 有 几 个 要 求 : 


e 绘图 应 该 看 起 来 不 错 - 发 布 质量 。 对 我 来 说 一 个 重要 的 要 求 是 文本 看 起 来 不 错 
( 抗 锯齿 等 ) 

用 于 包含 TeX 文档 的 Postscript 输出 

可 髋 入 图 形 用 户 界 面 用 于 应 用 程序 开发 

代码 应 该 足够 容易 ， 我 可 以 理解 它 ， 并 扩展 它 

绘图 应 该 很 容易 


没有 找到 适合 我 的 包 ， 我 做 了 任何 自称 Python 程序 员 会 做 的 事情 : 的 起 我 的 袖子 
开始 自己 造 。 我 没有 任何 丨 正 的 计算 机 图 形 经 验 ， 决 定 模仿 MATLAB 的 绘图 功 
能 ， 因 为 MATLAB 做 得 很 好 。 这 有 额外 的 优势 ， 许 多 人 有 很 多 MATLAB 的 经 验 ， 
因此 ， 他 们 可 以 很 快 开 始 在 python 中 绘图 。 从 开发 人 员 的 角度 来 看 ， 拥 有 固定 的 
用 户 接 口 (pylab 接口 ) 非常 有 用 ， 因 为 代码 库 的 内 容 可 以 重新 设计 ， 而 不 会 影响 
用 户 代 码 。 


Matplotlib 代码 在 概念 上 分 为 三 个 部 分 : pylab 接口 是 由 matplotlib.pylab 提供 
的 子 数 集 ， 人 允许 用 户 使 用 非常 类 似 于 MATLAB 图 生成 代码 (Pyplot 教程 ) 的 代码 
创建 绘图 。 Matplotlib 前 端 或 Matplotlib API 是 一 组 重要 的 类 ， 创 建 和 管理 图 形 > 
文本 ， 线 条 ， 图 表 等 (艺术 家 教程 ) 。 这 是 一 个 对 输出 无 所 了 解 的 抽象 接口 。 后 端 
是 设备 相关 的 绘图 设备 ， 也 称 为 泻 染 器 ， 将 前 端 表 示 转 换 为 打印 件 或 显示 设备 〈 什 
么 是 后 端 ? ) 。 后 端 示例 : PS 创建 PostScript@ 打印 件 ，SVG 创建 可 缩放 矢量 图 


形 打印 件 ，Agg 使 用 Matplotlib 附带 的 高 质量 掺 颗粒 几何 库 创 建 PNG 输出 ，GTK 
在 Gtk+ E MF PRA Matplotlib > GTKAgg 使 用 反 颗 粒 泻 染 器 创建 图 形 并 将 其 获 
入 到 Gtk+ 应 用 程序 中 ， 以 及 用 于 PDF > WxWidgets > Tkinter 等 。 


Matplotlib 被 很 多 人 在 许多 不 同 的 上 下 文中 使 用 。 有 些 人 希望 自动 生成 PostScript 
文件 以 发 送 给 打印 机 或 发 布 商 。 其 他 人 在 Web 应 用 程序 服务 器 上 部 署 Matplotlib 
来 生成 PNG 输出 ， 并 包含 在 动态 生成 的 网 页 中 。 一 些 人 在 Windows™ 上 的 
Tkinter 的 Python shell 中 以 交互 方式 使 用 Matplotlib。 我 的 主要 用 途 是 将 
Matplotlib # ^. Windows * Linux 和 Macintosh OS X 上 运行 的 Gtk+ EEG 应 用 程 
Fp Po 


[1] MATLAB 十 MathWorks 公司 的 注册 商标 。 
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原文 : Installing 

译 者 : 飞龙 

WA : CC BY-NC-SA 4.0 
有 许多 安装 matplotlib 的 不 同方 法 ， 最 好 的 方法 取决 于 你 使 用 的 操作 系统 ， 已 经 安 


装 的 内 容 以 及 如 何 使 用 它 。 为 了 避免 涉及 本 页 上 的 所 有 细节 (和 港 在 的 复杂 性 ) > 
有 几 个 方便 的 选项 。 


安装 预 构建 包 


$ 4-6 : Python 科学 分 发 包 


第 一 个 选项 是 使 用 已 经 内 置 matplotlib 的 预 打 包 的 Python 分 发 包 。 
Continuum.io Python 分 发 包 (Anaconda 或 miniconda) 和 Enthought 分 发 包 
(Canopy) 都 是 [在 Windows > OSX 和 主流 Linux 平台 开 箱 即 用 并 正常 工作 4 的 
出 色 选 择 。 这 两 个 分 发 包 包 括 matplotlib 和 许多 其 他 有 用 的 工具 。 
Linux : 使 用 你 的 包 管 理 器 
如 果 你 是 用 Linux， 你 可 能 更 倾向 于 使 用 包 管 理 器 。matplotlib 是 用 于 多 数 主 流 
Linux 发 行 版 的 包 。 


e Debian / Ubuntu: sudo apt-get install python-matplotlib 
e Fedora / Redhat: sudo yum install python-matplotlib 


Mac OSX : 使 用 pip 
如 果 你 使 用 MacOS， 你 可 以 使 用 Python 标准 安装 程序 pip 来 安装 matplotlib 二 
进 制 。 参 见 安 装 MacOS 二 进 制 轮 了 予 。 


Windows 


如 果 你 还 没有 安装 Python， 我 们 建议 使 用 兼容 SciPy 技术 栈 的 Python 分 发 版 本 ， 
如 WinPython > Python(x, y) > Enthought Canopy 或 Continuum Anaconda， 它 们 
含有 matplotlib 和 它 的 许多 依赖 ， 并 预 装 了 其 他 有 用 的 软件 包 。 


对 于 Python 的 标准 安装 ， 可 以 使 用 pip 安装 matplotlib : 


python -m pip install -U pip setuptools 
python -m pip install matplotlib 


如 果 没 有 为 所 有 用 户 安 装 Python 2.7 或 3.4， 则 需要 安装 Microsoft Visual C++ 
2008〈 对 于 Python 2.7 为 64 位 或 32 位 ) 或 Microsoft Visual C++ 2010 (对 于 
Python 3.4 为 64 位 或 32 位) 再 分 发 包 。 


Matplotlib 依赖 于 Pillow 来 读 取 和 保生 JPEG > BMP 和 TIFF 图 像 文件 。 Matplotlib 
需要 MiKTeX 和 GhostScript 来 使 用 LaTeX 泻 染 文 本 。 动 画 模块 需要 FFmpeg ° 
avconv * mencoder 或 ImageMagick ° 


以 下 后 端 应 该 开 箱 即 用 : agg > tkagg > ps > pdf 和 svg。 对 于 其 他 后 端 ， 你 可 能 需 
要 安装 pycairo，PyQt4，PyQt5，PySide，wxPython，PyGTK，Tornado X 
GhostScript ° 


TkAgg 可 能 是 来 自 标准 Python shell 或 IPython 的 ， 用 于 交互 式 的 最 佳 后 端 。 它 被 
局 用 为 官方 二 进 制 文件 的 默认 后 端 。 Windows 不 支持 GTK3 » 


PyPI 下 载 页 面 上 的 Windows 轮子 ( * .whl ) 不 包含 测试 数据 或 示例 代码 。 如 果 
你 想 尝试 matplotlib 源 代 码 中 的 许多 演示 ， 请 下 载 *.tar.gz 文件 并 得 

看 examples 子 目 录 。 要 运行 测试 套件 ， 请 将 源 代 码 发 行 版 中 

的 lib\matplotlib\tests 和 libNmpl toolkitsNtests 目录 分 别 复制 

到 sys.prefix\Lib\site-packages\matplotlib 和 sys.prefixNLibNsite-pac 
， 并 安装 nose，mock，Pilow，MiKTeX，GhostScript，ffmpeg，avconv ， 
mencoder > ImageMagick 和 Inkscape 。 


从 源码 安装 


如 果 你 有 兴趣 为 matplotlib 开发 做 贡献 ， 运 行 最 新 的 源 代 码 ， 或 者 只 是 想 自己 构建 
一 切 ， 从 源 代码 构建 matplotlib 并 不 困难 。 从 PyPI 文件 页 面 抓 取 最 新 

的 tar.gz 发 布 文件 ， 或 者 如 果 你 想 开 发 matplotlib 或 只 需要 最 新 的 bug 修复 版 
本 ， 获 取 最 新 的 git 版 本 ， 请 见 从 git 安装 。 


源 代码 遵守 标准 环境 变量 CC，CXX，PKG CONFIG 。 这 意味 着 如 果 你 的 工具 链 
有 前 级 ， 你 可 以 设置 它们 。 这 可 以 用 于 交叉 编译 。 


export CC=x86_64-pc-linux-gnu-gcc export CXX-x86 64-pc-linux-gnu 
-g++ export PKG CONFIG-x86 64-pc-linux-gnu-pkg-config 


一 旦 你 满足 的 了 面 的 具体 需求 (主要 是 Python、NumPy » libpng 和 freetype) ， 
你 就 可 以 构建 matplotlib 7 : 


cd matplotlib 
python setup.py build 
python setup.py install 


我 们 提供 与 setup.py 一 起 使 用 的 setup.cfg 文件 ， 你 可 以 使 用 它 来 自 定义 构建 
过 程 。 例 如 ， 要 使 用 的 默认 后 端 ， 是 否 安 装 matplotlib 附带 的 某 些 可 选 库 ， 等 等 。 
这 个 文件 会 对 那些 包装 matplotlib 的 东西 特别 有 用 。 


如 果 已 经 为 非 标准 设施 安装 了 必 备 组 件 ， 并 需要 通知 matplotlib 它们 在 哪里 ， 请 编 
Ht setupext.py 并 将 基本 路 径 添 加 为 sys.platform 的 basedir 字典 条 目 。 
例如 ， 如 果 东 些 所 需 库 的 头 文件 位 于 /some/path/include/someheader.h 中 ， 
请 在 你 的 平台 的 basedir 列表 中 输入 /some/path 。 


JERR 

这 些 是 外 部 软件 包 ， 你 需要 在 安装 matplotlib 之 前 安装 它们 。 如 果 你 在 OSX 49 
建 ， 请 参阅 在 OSX 上 构建 。 如 果 你 在 Windows 上 构建 ， 请 参阅 在 E 
建 。 如 果 在 Linux 上 使 用 软件 包 管理 器 安装 依赖 项 ， 则 除了 库 本 身 之 外 ， 还 可 能 需 
要 安装 开发 包 (查找 -dev GR) 。 

PT E TR RR 

Python 2.7 > 3.4° 3.5 或 3.6 

下 载 Python 


NumPy 1.7.1 (或 更 新 ) 

Python 的 数组 支持 (下载 NumPy) 
setuptools 

setuptools 为 Python 包 安 装 提供 扩展 
dateutil 1.1 或 更 新 


为 Python 时间 日 期 的 处 理 提供 扩展 。 如 果 使 用 了 pip ， easy_install 或 者 从 
源码 安装 ， 安 装 器 会 尝试 从 PyPl 下载 并 安装 python dateutil 。 


pyparsing 


需要 为 matplotlib 的 mathtext 数学 泻 染 提供 支持 。 如 果 使 用 
f pip ， easy install 或 者 从 源码 安装 ， 安 装 器 会 尝试 从 PyPl TF AL 
% pyparsing ° 


libpng 1.2 (或 更 新 ) 

用 于 加 载 和 保存 PNG 文件 (FR) ° libong 需要 zlib。 

pytz 

用 于 操作 时 区 感知 的 日 期 时 间 。https://pypi.python.org/pypi/pytz 
FreeType 2.3 或 更 新 


用 于 读 取 TrueType 字体 文件 。 如 果 使 用 了 pip ， easy_install 或 者 从 源码 安 
装 ， 安 装 器 会 尝试 从 预期 位 置 定位 FreeType。 如 果 找 病毒 奥 ， 尝 试 安装 pkg- 
config， 用 于 寻找 所 需 非 Python 库 的 工具 。 


cycler 0.10.1 或 更 新 


可 组 合 的 循环 类 ， 用 于 构造 style-cycle。 
SIX 


需要 用 于 Python 2 和 3 之 间 的 兼容 性 


Python 2 的 依赖 

functools32 

需要 用 于 Python 2.7 上 的 兼容 性 

subprocess32 

可 选 ， 仅 用 于 Unixe subprocess 标准 库 从 3.24 到 2.7 的 Backport。 它 提供 了 更 
好 的 错误 信息 和 超时 支持 。 


选 的 GUI 1E 7& 
这 些 是 可 选 软件 包 ， 你 可 能 希望 安装 
包 。 有关 matplotlib 可 选 后 端 和 所 提 人 
tk 8.3 或 更 新 ， 不 包括 8.6.0 和 8.6.1 
TkAgg 后 端 使 用 的 TCL/Tk 窗口 控件 库 。 
版 本 8.6. 0 和 8.6.1 已 知 有 问题 ， 当 以 错误 的 顺序 关闭 多 个 窗口 时 可 能 导致 段 错 


TK ° 

pyqt 4.4 或 更 新 

Qt4 控件 库 的 Python 包装 ， 用 于 Qt4Agg 后 端 。 

pygtk 2.4 或 更 新 

GTK 控件 库 的 Python 包装 ， 用 于 GTK 或 者 GTKAgg 后 端 。 
wxpython 2.8 或 更 新 

wx 控件 库 的 Python 包装 ， 用 于 WX 或 WXAgg 后 端 。 


这 些 软件 包 来 使 用 matplotlib 和 用 Pd LA 
供 功能 的 更 多 详细 信息 ， 请 参阅 什么 是 后 端 。 


选 的 外 部 程序 
ffmpeg/avconv 或 mencoder 
需要 用 于 动画 模块 ， 将 输出 保存 为 电影 格式 。 
ImageMagick 
需要 用 于 动画 模块 ， 能 够 保存 GIF 动画 。 


可 选 依赖 

Pillow 

如 果 安 装 了 Pillow，matplotlib 可 以 读 取 或 写 入 大 部 分 图 像 文件 格式 。 

pkg-config 

用 于 寻找 所 需 非 Python 库 的 工具 。 并 不 是 严格 需要 它 ， 但 是 如 果 库 和 头 文件 不 在 
预期 位 置 ， 可 以 使 安装 更 加 便捷 。 


matplotlib 目 带 的 所 需 库 


agg 2.4 


C++ 泻 染 引擎 。 matplotlib 静态 链接 到 agg 模板 源码 ， 所 以 它 除 了 matplotlib 之 
外 ， 不 会 影响 你 的 系统 的 任何 东西 。 


qhull 2012.1 
用 于 计算 Delaunay 三 角 测 量 的 库 。 
ttconv 


TureType 字体 工具 。 


在 Linux 上 构建 
使 用 你 的 系统 包 管 理 器 来 安装 依赖 最 为 简单 。 


如 果 你 使 用 Debian/Ubuntu， 可 以 使 用 以 下 命令 在 获取 需要 用 于 构建 matplotlib 的 
所 有 依赖 : 


sudo apt-get build-dep python-matplotlib 
如 果 你 使 用 Fedora/RedHat， 你 可 以 使 用 以 下 命令 : 
su -c "yum-builddep python-matplotlib" 
这 不 会 构建 matplotlib， 但 这 会 安装 所 需 依 赖 。 这 会 使 从 源码 构建 变 得 容易 。 


在 OSX 上 构建 


由 于 可 以 获取 libpng 和 freetype $ (darwinports > fink > /usr/X11R6) 的 不 
同人 位置， 不同 的 架构 《例如 X86，ppc，universal) 和 不 同 的 OSX 版 本 10.4 和 
10.5) > OSX 的 构建 情况 很 复杂 。 我 们 建议 你 使 用 我 们 对 OSX 版 本 所 做 的 方式 来 


构建 : 从 tarball 或 git 仓库 获取 源 代 码 ， 并 按照 README.osx 中 的 说 明 进 行 
操作 。 


在 Windows 上 构建 


https://www.python.org EX ay Python ， 使 用 VS2008 编译 3.3 之 前 的 版 本 ， 使 
用 VS2010 编译 3.3， 并 且 使 用 VS2015 编译 3.5 和 3.6。 建议 使 用 相同 的 编译 器 
编译 Python 扩展 。 


由 于 没有 规范 的 Windows 包 管 理 器 ， 从 源 代 码 构 


建 freetype ， zlib 和 libpng 的 方法 被 记录 为 matplotlib-winbuild 中 的 
构建 脚本 。 


教程 


pyplot 教程 


原文 : Pyplot tutorial 

译 者 : 飞龙 

协 仅 : CC BY-NC-SA 4.0 
matplotlib.pyplot 是 一 个 命令 风格 函数 的 集合 ， 使 matplotlib 的 机 制 更 像 
MATLAB 。 每 个 绘图 函数 对 图 形 进行 一 些 更 改 : 例如 ， 创 建 图 形 ， 在 图 形 中 创建 给 
图 区 域 ， 在 绘图 区 域 绘制 一 些 线条 ， 使 用 标签 装饰 绘图 等 。 
在 matplotlib.pyplot 中 ， 各 种 状态 跨 函 数 调用 保 行 ， 以 便 跟 踪 诸 如 当前 图 形 和 
绘图 区 域 之 类 的 东西 ， 并 且 绘 图 函数 始终 指向 当前 轴 域 (请 注意 ， 这 里 和 文档 中 的 
大 多 数位 置 中 的 『 轴 域 」 (axes) 是 指 图 形 的 一 部 分 (两 条 坐标 轴 围 成 的 区 域 ) ， 
而 不 是 指 代 多 于 一 个 轴 的 严格 数学 术语 ) o 


import matplotlib.pyplot as plt 
plt.plot([1,2,3,4]) 
plt.ylabel('some numbers ') 
plt.show() 


4.0 
3.5 
3.0 


2.5 


some numbers 


2.0 


1.5 


1.0 


0.0 0.5 1.0 1.5 2.0 2.5 3.0 


你 可 能 想 知 道 为 什么 x 轴 的 范围 为 0-3 > y 轴 的 范围 为 1-4 。 如 果 你 

向 plot() 命令 提供 单个 列表 或 数组 ， 则 matplotlib 假定 它 是 一 个 y H/F > 
并 自动 为 你 生成 x tic HT python 范围 从 0 开始， 默认 x 向 量具 有 与 y 相同 
的 长 度 ， 但 从 0 开始 。 因 此 x 数据 是 [0,1,2,3] ° 


plot() 和 一 个 通用 命令 ， 并 且 可 接受 任意 数量 的 参数 。 例如 ， UR 
制 x 和 y ， 你 可 以 执行 命令 : 


plt.plot([1, 2, 8, 4], [1, 4, 9, 16]) 


对 于 每 个 x,y 参数 对 ， 有 一 个 可 选 的 第 三 个 参数 ， 它 是 指示 图 形 颜色 和 线条 类 型 
的 格式 字符 事 。 格 式 字符 串 的 字母 和 符号 来 自 MATLAB， 并 且 将 颜色 字符 串 与 线 
型 字符 串 连接 在 一 起 。 默 认 格式 字符 串 为 "b." ， 它 是 一 条 蓝 色 实 线 。 例 如 ， 要 
绘制 上 面 的 红色 圆圈 ， 你 需要 执行 : 


import matplotlib.pyplot as plt 
plt.plot([1,2,3,4], [1,4,9,16], 'ro') 
plt.axis([0, 6, ©, 20]) 

plt.show() 


有 关 线 型 和 格式 字符 串 的 完整 列表 ， 请 参见 plot() x45» 上 例 中 的 axis() 命 
令 接 收 [xmin，xmax，ymin，ymax] 的 列表 ， 并 指定 轴 域 的 可 视 区 域 。 


如 果 matplotlib 仅 限 于 使 用 列表 ， 它 对 于 数字 处 理 是 相当 无 用 的 。 一 般 来 说 ， 
你 可 以 使 用 numpy 数组 。 事 实 上 ， 所 有 友 列 都 在 内 部 转换 为 numpy 数组 。 下 面 
的 示例 展示 了 使 用 数组 和 不 同 格式 字符 串 ， 在 一 条 命令 中 绘制 多 个 线条 。 


import numpy as np 
import matplotlib.pyplot as plt 


LL FANLA VA ] /i COAMA | FK» £^ 4 e | rr "a | 4 7?) C Ci We. 3 V^ 4- AVALA ] co 
# evenly sampled time at 200ms intervals 


t = np.arange(0., 5., 0.2) 
































TL wR A NAC ^ "x 0 PN ] IIA CNILIAYF A C Arn "1 ^" V^ X €XYO $- y A nm ] A cC 
# red dashes, blue squares and green triangles 


plt.plot(t, t, 'r--', E pup 'bs', t, te oe 'g\' ) 
plt.show( ) 
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控制 线条 属性 
线条 有 许多 你 可 以 设置 的 属 
性 : linewidth ， dash style ， antialiased 等 ， 请 参 


X, matplotlib.lines.Line2D ° 有 几 种 方法 可 以 设置 线 属 性 : 
@ 使 用 关键 宁 参 数 


plt.plot(x, y, linewidth-z2.90) 


e 使 用 Line2D 实例 的 setter 方法 。 plot 返回 Line2D 对 象 的 列表 ， 例 
如 linei,line2 = plot(x1，y1，x2，y2) ° 在 下 面 的 代码 中 ， 我 们 假设 只 
有 一 行 ， 效 回 的 列表 发 度 为 1。 我 们 对 line 使 用 元 组 解构 ， 得 到 该 列表 的 第 
6r P 


line, = plt.plot(x, y, - ) 
line.set antialiased(False) # turn off antialising 


e 使 用 setp() 命令 。 下面 的 示例 使 用 MATLAB 风格 的 命令 来 设置 线条 列表 上 
的 多 个 属性 。 setp 使 用 对 象 列 表 或 单个 对 象 透明 地 工作 。 你 可 以 使 用 
python 关键 字 参 数 或 MATLAB 风格 的 字符 串 / 值 对 : 


lines = plt. plot(x1, y1, x2, y2) 

# 使 用 关键 字 参 数 

plt.setp(lines, color='r', linewidth=2.0) 

# 或 者 MATLAB 风格 的 字符 串 值 对 

plt.setp(lines, 'color', 'r', 'linewidth', 2.0) 


下 面 是 可 用 的 Line2D 属性 


属性 值 类 型 
alpha 浮 点 值 
animated [True / False] 
antialiased or aa [True / False] 
clip box matplotlib.transform.Bbox 实例 
clip_on [True / False] 
clip_path Path 实例 ， Transform ， 以 及 Patch 实例 
color or c 任何 matplotlib ARE 
contains 命中 测试 函数 
dash_capstyle ['butt' / 'round' / 'projecting'] 
dash_joinstyle ['miter' / round / 'bevel'] 
dashes 以 点 为 单位 的 连接 / 断 开 过 水 友 列 
data (np.array xdata, np.array ydata) 
figure matplotlib.figure.Figure 实例 
label FESTE RE P 


linestyle or 1s ELO A if SSIS 76 = 


要 获取 可 设置 的 线条 属性 的 列表 ， 请 以 一 个 或 多 个 线条 作为 


处 理 多 个 图 形 和 轴 域 


有 当前 图 形 和 当前 轴 域 的 概念 。 所 有 绘 
SX gca() 返回 当前 轴 域 (一 个 matplotlib.axes.Axes X 


MATLAB 和 pyplot # 
域 。 


linewidth or lw 

lod 

marker 

markeredgecolor or mec 
markeredgewidth or mew 
markerfacecolor or mfc 
markersize or ms 
markevery 

picker 

pickradius 
solid_capstyle 
solid_joinstyle 
transform 

visible 

xdata 

ydata 


zorder 


In [69]: lines - 
In [70]: 
alpha: float 
animated: [True | 
antialiased or aa: 
. Snip 


plt.setp(lines) 


False] 
[True | 


以 点 为 单位 的 浮 点 值 


[True / False] 
[ ML SU 


l / i IR / ^ / Be / 1 


任何 matplotlib ARE 


任何 matplotlib ARE 


E: Je 值 


[ None / 整数 值 / (startind, 
用 于 交互 式 线条 选择 


线条 条 的 拾取 选 先 择 半径 
['butt' / 


['miter' / 


matplotlib.transforms.Transform 


[True / False] 
np.array 


np.array 


任何 数值 


plt.plot([i, 2, 3]) 


False |] 


Stride) | 


'round' / ‘projecting’ | 


round / ‘bevel’ ] 


实例 


参数 调用 step() 函数 


命令 适 


用 于 当前 轴 


f|) > gcf() 返回 当前 图 形 〈 matplotlib.figure.Figure 实例 ) ° 通 第 ， 你 


不 必 担 心 


这 一 点 ， 因 为 它 都 是 在 幕后 处 理 。 下 面 是 一 个 创建 两 个 子 图 的 脚本 。 


import numpy as np 
import matplotlib.pyplot as plt 


def f(t): 
return np.exp(-t) * np.cos(2*np.pi*t) 


t1 
t2 


np.arange(0.0, 5.0, 0.1) 
np.arange(0.0, 5.0, 0.02) 


plt.figure(1) 
plt.subplot( 211) 
plt.plot(ti, f(t1), 'bo', t2, f(t2), 'k') 


plt.subplot(212) 
plt.plot(t2, np.cos(2*np.pi*t2), 'r--') 
plt.show() 





这 里 的 figure() 命令 是 可 选 的 ， 因 为 默认 情况 下 将 创建 figure(1) ， 如 果 不 手 
动 指定 任何 轴 域 ， 则 默认 创建 subplot(111) ° subplot() 命令 指 

定 numrows * numcols ， fignum ， 其 中 fignum 的 范围 是 

从 1 到 numrows * numcols ° 如 有 果 numrows * numcols «10 ， 

则 subplot 命令 中 的 过 号 是 可 选 的 。 因 此 ， 子 

图 subplot(211) 与 subplot(2, 1, 1) 相同 。 你 可 以 创建 任意 数量 的 子 图 和 和 罗 
Jo 如 果 要 手动 放置 轴 域 ， 即 不 在 矩形 网 格 上 ， 请 使 用 axes() 命令 ， 该 命令 允 

许 你 将 axes([left, bottom, width, height]) 指定 为 位 置 ， 其 中 所 有 值 都 使 


用 小 数 (0 到 1) 坐标 。 手动 放置 轴 域 的 示例 请 参见 pylab_examples 示例 代 
码 : axes demo.py ， 具 有 大 量子 图 的 示例 请 参见 pylab examples 示例 代 

码 : subplots demo.py ° 

你 可 以 通过 使 用 递增 图 形 编号 多 次 调用 figure() 来 创建 多 个 图 形 。 当然 ， 每 个 
数字 可 以 包含 所 需 的 轴 和 子 图 数量 : 


import matplotlib.pyplot as plt 


plt .figure(1) # 第 一 个 图 形 
plt.subplot( 211) # 第 一 个 图 形 的 第 一 个 子 图 
plt.plot([1, 2, 3]) 

plt.subplot(212) # o-—4- BE S $S—4 3 8 


plt.plot([4, 5, 6]) 


plt.figure(2) # 第 二 个 图 形 

plt.plot([4, 5, 6]) # 默认 创建 subplot(111) 
plt.figure(1) # 当前 是 图 形 1，subplot(212) 
plt.subplot(211) # 将 第 一 个 图 形 的 subplot(211) 设 为 当前 
a 


plt.title('Easy as 1, 2, 3') # TA 211 的 标题 


你 可 以 使 用 clf() 清除 当前 图 形 ， 使 用 cla() 清除 当前 轴 域 。 如 果 你 摘 不 清 在 
幕后 维护 的 状态 〈 特 别 是 当前 的 图 形 和 轴 域 ) ， 不 要 绝望 : 这 只 是 一 个 面向 对 象 的 
API 的 简单 的 状态 包装 器 ， 你 可 以 使 用 面向 对 象 API ( 见 艺术 家 教程 ) 。 


如 果 你 正在 制作 大 量 的 图 形 ， 你 需要 注意 一 件 事 : 在 一 个 图 形 用 close() LAX 
闭 之 前 ， 该 图 所 需 的 内 存 不 会 完全 释放 。 删除 对 图 形 的 所 有 引用 ， 和 /或 使 用 窗口 
管理 器 杀 死 屏幕 上 出 现 的 图 形 的 窗口 是 不 够 的 ， 因 为 在 调用 close() 之 

前 ， pyplot 会 维护 内 部 引用 。 


处 理 文 本 


text() 命令 可 用 于 在 任意 位 置 添加 文 
A> xlabel() > ylabel() 和 title() 用 于 在 指定 的 位 置 添加 文本 (详细 示 
例 请 参阅 文本 介绍 ) 。 


Pyplot 教程 


import numpy as np 
import matplotlib.pyplot as plt 


mu, sigma - 100, 15 
x = mu + sigma * np.random.randn(10000) 


# 数据 的 直方 图 
n, bins, patches = plt.hist(x, 50, normed-i, facecolor-'g', alph 
a=0.75) 


plt.xlabel('Smarts') 
plt.ylabel('Probability!') 
plt.title('Histogram of IQ') 

plt.text(60, .025, r'$\mu=100,\ \sigma=15$' ) 
plt.axis([40, 160, 0, 0.03]) 

plt.grid( True) 

plt.show( ) 


Histogram of IQ 


0.030 


0.025 


0.070 


0.015 


Probability 


0.010 


0.005 





eie text() 命令 返回 一 个 matplotlib.text.Text 实例 。 与 上 面 一 样 ， 你 可 
过 将 关键 字 参 数 传 递 到 text 函数 或 使 用 setp() 来 自 定 义 属 性 


= plt.xlabel('my data', fontsize=14, color='red' ) 


些 属 性 的 更 详细 介 见 文本 属性 和 布局 。 
20 


在 文本 中 使 用 数学 表达 式 


matplotlib 在 任何 文本 表达 式 中 接受 TeX 方程 表达 式 。 例 如 ， 要 在 标题 中 写 入 
表达 式 ， 可 以 编写 一 个 由 美元 符号 包围 的 TeX RAK: 


plt.title(r'$Nsigma i-15$') 


标题 字符 串 之 前 的 r 很 重要 - CARAFA PEARFA P” mA E 
杠 作为 python 转 义 处 理 。 matplotlib 有 一 个 内 置 的 TeX 表达 式 解 析 器 和 布局 
引擎 ， 并 且 自 带 了 自己 的 数学 字体 -详细 信息 请 参阅 编写 数学 表达 式 。 因此 ， 你 可 
以 跨 平 台 使 用 数学 文本 ， 而 无 需 安 装 TeX。 对 于 安装 了 LaTeX 和 dvipng 的 用 

户 ， 还 可 以 使 用 LaTeX 格式 化 文本 ， 并 将 输出 直接 合并 到 显示 图 形 或 保存 的 
postscript 中 - 请 参阅 使 用 LaTeX 进行 文本 泻 染 。 


标注 文本 


上 面 的 text() 基本 命令 将 文本 放置 在 轴 域 的 任意 位 置 。 文 本 的 一 个 常见 用 法 是 
对 图 的 某 些 特征 执行 标注 ， 而 annotate() 方法 提供 一 些 辅助 功能 ， 使 标注 变 得 
容 甸 。 在 标注 中 ， 有 两 个 要 考虑 的 点 : 由 参数 xy 表示 的 标注 位 置 和 xytext X 
示 的 文本 位 置 。 这 两 个 参数 都 是 (x, y) 元 组 。 


local max 





在 此 基本 示例 中 ， xy (箭头 提示 ) 和 xytext (文本 ) 都 位 于 数据 坐标 中 。 有 
多 种 其 他 坐标 系 可 供 选择 - 详细 信息 请 参阅 标注 文本 和 标注 轴 域 。 更 多 示例 可 以 
在 pylab_examples 示例 代码 : annotation_demo.py 中 找到 。 


对 数 和 其 它 非 线性 轴 


matplotlib.pyplot 不 仅 支持 线性 轴 刻 度 ， 还 支持 对 数 和 对 数 刻 度 。 如 果 数 据 
跨越 许多 数量 级 ， 通 第 会 使 用 它 。 更 改 轴 的 刻度 很 容 匈 : 


plt.xscale('log') 


下 面 示例 显示 了 四 个 图 ， 具 有 相同 数据 和 不 同 刻 度 的 y 轴 。 


import numpy as np 
import matplotlib.pyplot as plt 


生成 一 些 区 间 [o, 1] 内 的 数据 

= np.random.normal(loc=0.5, scale=0.4, size-1000) 
= y[(v > 9) & (y < 1)] 

.Sort() 

- np.arange(len(y)) 


x< << dt 


# 带 有 多 个 轴 域 刻度 的 plot 
plt.figure(i) 


# 线性 
plt.subplot(221) 
plt.plot(x, y) 
plt.yscale('linear') 
plt.title('linear') 
plt.grid(True) 


# 对 数 
plt.subplot(222) 
plt.plot(x, y) 
plt.yscale('log') 
plt.title('log') 
plt.grid(True) 


# 对 称 的 对 数 

plt.subplot(223) 

plt.plot(x, y - y.mean()) 
plt.yscale('symlog', linthreshyz0.05) 
plt.title('symlog') 

plt.grid(True) 


# logit 
plt.subplot(224) 
plt.plot(x, y) 
plt.yscale('logit') 
plt.title('logit') 
plt.grid(True) 


plt.show() 
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图 像 教 程 


原文 : Image tutorial 
译 者 : 飞龙 
WU : CC BY-NC-SA 4.0 


尼 动 命令 


首先 ， 让 我 们 启动 IPython » 它 是 Python 标准 提示 符 的 最 好 的 改进 ， 它 与 
Matplotlib 配合 得 相当 不 错 。 在 shell 或 IPython Notebook 上 都 可 以 启动 
IPython 。 


ka a IPython 启动， 我 们 现在 需要 连接 到 GUI 事件 循环 。 它 告诉 IPython 在 哪里 
(以 及 如 何 显示 ) 绘图 。 要 连接 到 GUI 循环 ， 请 在 IPython 提示 符 处 执 
fr %matplotlib 魔法 。 在 IPython 的 GUI 事件 循环 文档 中 有 更 多 的 细节 。 


如 果 使 用 IPython Notebook， 可 以 使 用 相同 的 命令 ， 但 人 们 通常 以 特定 参数 使 
用 %matplotlib 


In [1]: %matplotlib inline 


这 将 打开 内 联 绘图 ， 绘 图 图 形 将 显示 在 笔记 本 中 。 这 对 交互 性 有 很 重要 的 影响 。 
对 于 内 联 绘图 ， 在 单元 格 下 方 的 单元 格 中 输出 绘图 的 命令 不 会 影响 绘图 。 例 如 ， 从 
创建 绘图 的 单元 格 下 面 的 单元 格 更 改 颜 色 表 是 不 可 能 的 。 但 是 ， 对 于 其 他 后 端 ， 例 
如 qt4， 它 们 会 打开 一 个 单独 的 窗口 ， 那 些 创建 绘图 的 单元 格 下 方 的 单元 格 将 改变 
绘图 - 它 是 一 个 内 大 中 的 活 对 人 象 。 


本 教程 将 使 用 matplotlib 的 命令 式 绘 图 接口 pyplot 。 该 接口 维护 全 局 状态 ， 
并 且 可 用 于 简单 快速 地 尝试 各 种 绘图 设置 。 另 一 种 是 面向 对 象 的 接口 ， 这 也 非常 强 
大 ， 一 般 更 适合 大 型 应 用 程 厚 的 开发 。 如果 你 想 了 解 面向 对 象 接 口 ， 使 用 上 的 第 见 
问题 是 一 个 用 于 起 步 的 不 错 的 页 面 。 现 在 ， 让 我 们 继续 使 用 命令 式 方式 : 


In [2]: import matplotlib.pyplot as plt 
In [3]: import matplotlib.image as mpimg 
In [4]: import numpy as np 


将 图 像 数据 导入 到 NumPy 数组 


加 载 图 像 数 据 由 Pillow 库 提供 支持 。 AR? matplotlib 只 支持 PNG 图 像 。 如 
果 本 机 读 取 失 败 ， 下 面 显示 的 命令 会 回 退 到 Pillow 。 


图 像 教程 


此 示例 中 使 用 的 图 像 是 PNG 文件 ， 但 是 请 记 住 你 自己 的 数据 的 Pillow 有 要求。 
下 面 是 我 们 要 摆弄 的 图 片 : 





一 个 24 位 RGB PNG 图 像 (每 个 R，G，B 为 8 位 ) 。 根 据 你 获取 数据 的 位 
处 最 有 可 | 的 其 他 类 型 的 图 像 是 RGBA 图 像 ， 拥 有 透明 度 或 单 通道 灰 度 
t) 的 图 像 。 你 可 以 右键 单 击 它 ， 和 选择 Save image as (AGA) 为 本 教程 
余部 分 下 载 到 你 的 计算 机 。 


现在 我 们 开始 ... 


P 
»m 


In [5]: img=mpimg.imread('stinkbug.png' ) 

Out[5]: 

array([[[ 0.40784314, 0.40784314, 0.40784314], 
[ 0.40784314, 0.40784314, 0.40784314], 
[ 0.40784314, 0.40784314, 0.40784314], 


© = 


.42745098, 0.42745098, ©.42745098], 
.42745098, 0.42745098, 0.42745098], 
.42745098, 0.42745098, ©.42745098]], 


oa © 


[ 
[ 
[ 


44313726, 0,44313726， 0.44313726], 
.4509804 , 0.4509804 , 0.4509804 |, 
.4509804 , 0.4509804 , 0.4509804 |, 


r— r3 m 
3 © ©) OS 


0.44705883, 0.44705883, 0.44705883], 
0.44705883, 0.44705883, 0.44705883], 
0.44313726, 0.44313726, 0.44313726]]], dtype=float32 


[Basa 
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图 像 教 程 


注意 这 里 的 dtype - float32 。 Matplotlib 已 将 每 个 通道 的 8 位 数据 重新 定 标 为 
0.0 和 1.0 之 间 的 浮 点 数 。 MEA Fiz > Pillow 可 以 使 用 的 唯一 数据 类 型 

Æ uint8 ° Matplotlib 绘图 可 以 处 理 float32 和 uint8 ， 但 是 对 于 除 PNG 之 
外 的 任何 格式 的 图 像 ， 读 取 / 写 入 仅 限 于 uint8 数据 。 为 什么 是 8 位 呢 ? 大 多 数 
显示 器 只 能 渔业 每 通道 8 位 的 颜色 渐变 。 为 什么 他 们 只 能 泻 染 每 通道 BME? 
为 这 会 使 所 有 人 的 眼睛 可 以 看 到 。 更 多 信息 请 见 (从 摄影 的 角度 ) :Luminous 
Landscape 位 深度 教程 。 


每 个 内 部 列表 表示 一 个 像素 。 这 里 ， 对 于 RGB 图 像 ， 有 3 个 值 。 由 于 它 是 一 个 黑 
白 图 像 ，R，G 和 B 都 是 类 似 的 。RGBA (其 中 人 是 阿尔 法 或 透明 度 ) 对 于 每 个 内 
部 列表 具有 4 个 值 ， 而 且 简 单 完 度 图 像 仅 具有 一 个 值 (因此 仅 是 二 维 数 组 ， 而 不 是 
三 维 数组 ) e 对 于 RGB 和 RGBA 图 像 ，matplotlib X 

持 float32 和 uint8 数据 类 型 。 对 于 灰 度 ， matplotlib 只 支持 float32 。 
如 果 你 的 数组 数据 不 符合 这 些 描述 之 一 ， 则 需要 重新 缩放 它 。 


将 NumPy 数组 绘制 为 图 像 

所 以 ， 你 将 数据 保存 在 一 个 numpy 数组 (通过 导入 它 ， 或 生成 它 ) 。 URMEZ 
它 吧 。 在 Matplotlib 中 ， 这 是 使 用 imshow() 有 函数 执行 的 。 这 里 我 们 将 抓 

FL plot 对 象 。 这 个 对 象 提供 了 一 个 简单 的 方法 来 从 提示 符 处 理 绘图 。 


In [6]: imgplot = plt.imshow(img) 





0 LOO 200 300 400 300 


你 也 可 以 绘制 任何 NumPy 数组 。 
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p EROR E SLE OUS EX 


伪 彩 色 可 以 是 一 个 有 用 的 工具 9 用 于 增强 对 比 度 和 更 易于 可 视 化 你 的 数据 ` 这 在 使 
用 投影 仪 对 你 的 数据 进行 演示 时 尤其 有 用 它们 的 对 比 度 通常 很 差 


伪 彩 色 仅 与 单 通道 ， 灰 度 ， 亮 度 图 像 相关 。 我 们 目前 有 一 个 RGB 图 像 。 由 于 R，G 
fe B 都 是 相似 的 〈《 见 上 面 或 你 的 数据 ) ， 我 们 可 以 只 选择 一 个 通道 的 数据 : 
In [7]: lum img = img[:,:,90] 


这 是 数组 切片 ， 更 多 信息 请 见 NumPy 教程 。 


In [8]: plt.imshow(lum img) 





Ü 100 200 300 400 500 
HME’ SF (2D， 无 颜色 ) AREA T RUMOR (也 称 为 查找 表 ，LUT) » X 
认 值 称 为 jet 。 有 很 多 其 他 方案 可 以 选择 。 


In [9]: plt.imshow(lum img, cmap="hot") 


28 


图 像 教程 





0 LOO 200 300 400 300 


请 注意 ， 你 还 可 以 使 用 set cmap() X EARRA RA TAEKE : 


In [16]: imgplot - plt.imshow(lum img) 
In [11]: imgplot.set cmap( spectral') 
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200 


300 


350 





0 100 200 300 400 200 


VE. 


但 是 ， 请 记 住 ， 在 带 有 内 联 后 端的 [Python notebook 中 ， 能 对 已 经 演 染 的 
绘图 进行 更 改 。 如 果 你 在 一 个 单元 格 中 创建 了 imgplot 你 下 能 在 以 后 的 单 
eT ' 并且 改变 前 面 的 绘 Y ARI ER T EAI 
一 起 输入 这 aza  "$wperp eei. 


有 许多 可 选 的 其 它 磊 色 表 ， 请 见 闫 色 表 的 列表 和 图 像 。 
MEA EAA 
了 解 凑 色 代 表 什 么 值 对 我 们 很 有 帮助 。 我 们 可 以 通过 添加 顾 色 条 来 做 到 这 o 


In [12]: imgplot - plt.imshow(lum img) 
In [13]: plt.colorbar() 





0 100 200 300 400 300 





0.0 


ZAARRA 89 AWG Za — A ERE, o de RARE CA ORAM MERA? WA 
会 目 动 更 改 - dus S de EIE > PRISE o 


d BAF RAE Ie 


有 时 ， 你 想 要 增强 图 像 的 对 比 度 ， 或 者 扩大 特定 区 域 的 对 比 度 ， 同 时 牺牲 变化 不 
大 ， 或 者 无 所 谓 的 颜色 细节 。 找到 有 趣 区 域 的 最 好 工具 是 直方 图 。 要 创建 我 们 的 
图 像 数据 的 直方 图 ， 我 们 使 用 hist() Bako 


In [14]: plt.hist(lum img.ravel(), bins-256, range=(0.0, 1.0), f 
c='k', ec-'k') 


8000 


6000 


4000 


2000 





0.0 0.2 0.8 1.0 


通常 ， 图 像 的 『 有 趣 」 部 分 在 峰值 附近 ， 你 可 以 通过 剪 切 峰值 上 方 和 /或 下 方 的 区 域 
获得 额外 的 对 比 度 。 在 我 们 的 直方 图 中 ， 看 起 来 最 大 值 处 没有 太 乡 有 用 的 信息 (图 
像 中 有 很 多 不 是 白色 的 东西 ) 。 让 我 们 调整 上 限 ， 以 便 我 们 有 效 地 『 放 大 J 直方 图 
的 一 部 分 。 我 们 通过 将 clim 参数 传递 给 imshow 来 实现 。 你 也 可 以 通过 对 图 像 
绘图 对 象 调用 set clim() 方法 来 做 到 这 一 点 ， 但 要 确保 你 在 使 用 IPython 
Notebook 的 时 候 ， 和 plot 命令 在 相同 的 单元 格 中 执行 - 它 不 会 改变 之 前 单元 格 
的 图 。 


In [15]: imgplot = plt.imshow(lum img, clim=(0.0, 0.7)) 


Before After 





数组 插值 方案 


插值 根据 不 同 的 数学 方案 计算 像素 『 应 有 J 的 颜色 或 值 。 发 生 这 种 情况 的 一 个 第 见 
的 场景 是 调整 图 像 的 大 小 。 像素 的 数量 会 发 生变 化 ， 但 你 想 要 相同 的 信息 。 由 于 
像素 是 离散 的 ， 因 此 存在 缺失 的 空间 。 插值 就 是 填补 这 个 空间 的 方式 。 这 就 是 当 
你 放大 图 像 时 ， 你 的 图 像 有 时 会 出 来 看 起 来 像素 化 的 原因 。 当 原 始 图 像 和 扩展 图 像 
之 间 的 差异 较 大 时 ， 效 果 更 加 明显 。 让 我 们 加 载 我 们 的 图 像 并 缩小 它 。 我 们 实际 
上 正在 丢弃 像素 ， 只 保留 少数 几 个 像素 。 现在 ， 当 我 们 绘制 它 时 ， 数 据 被 放大 为 你 
屏幕 的 大 小 。 由 于 日 的 像素 不 再 存在 ， 计 和 民 机 必须 绘制 像素 来 填充 那个 空间 。 


我 们 将 使 用 用 来 加 载 图 像 的 Pillow 库 来 调整 图 像 大 小 。 


In [16]: from PIL import Image 

In [17]: img = Image.open('../ static/stinkbug.png') 

In [18]: img.thumbnail((64, 64), Image.ANTIALIAS) # resizes imag 
e in-place 

In [19]: imgplot - plt.imshow(img) 


图 像 教程 





这 里 我 们 使 用 默认 插值 ， 双 线性 ， 因 为 我 们 没有 向 imshow() 提供 任何 插值 参数 。 
让 我 们 试 试 一 些 其 它 的 东西 : 


也 邻近 


In [26]: imgplot = plt.imshow(img, interpolation="nearest" ) 
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图 像 教程 





双 立 方 


In [21]: imgplot = plt.imshow(img, interpolation="bicubic" ) 


图 像 教程 





双 立 方 插值 通常 用 于 放大 照片 -人 们 倾向 于 模糊 而 不 是 过 度 像 素 化 。 
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使 用 GridSpec 目 定 义 子 图 位 置 


原文 : Customizing Location of Subplot Using GridSpec 
FA : 飞龙 
协 仅 : CC BY-NC-SA 4.0 

GridSpec 


指定 子 图 将 放置 的 网 格 的 几何 位 置 。 需 要 设置 网 格 的 行 数 和 列 数 。 子 图 布局 参数 
(例如 ， 左 ， 右 等 ) 可 以 选择 性 调整 。 


SubplotSpec 

指定 在 给 定 GridSpec 中 的 子 图 位 置 。 

subplot2grid 

— ^A Bh BA > RUF pyplot.subplot ， 但 是 使 用 基于 0 的 索引 ， 并 可 使 子 图 
BERG NEF o 


subplot2grid 基本 示例 


要 使 用 Subplot2grid， 你 需要 提供 网 格 的 几何 形状 和 网 格 中 子 图 的 位 置 。 对 于 简单 
的 单 网 格子 图 : 


ax = plt.subplot2grid((2,2),(0, 9)) 


A 
> 
—h 


ax = plt.subplot(2,2,1) 


(0,9) +------- Eee + 
| 1 | | 
Do qe 十 
| | | 
ous — 十 


要 注意 不 想 subplot ， gridspec 中 的 下 标 从 0 开始 。 
为 了 创建 跨越 多 个 格子 的 子 图 ， 


ax2 
ax3 


plt.subplot2grid((3,3), (4, 0), colspan=2) 
plt.subplot2grid((3,3), (4, 2), rowspan=2) 


例如 ， 下 列 命令 : 


ax1 = plt.subplot2grid((3,3), (0,0), colspan=3) 
ax2 = plt.subplot2grid((3,3), (1,9), colspan=2) 
ax3 = plt.subplot2grid((3,3), (1, 2), rowspan=2) 
ax4 = plt.subplot2grid((3,3), (2, 9)) 
axb - plt.subplot2grid((3,3), (2, 1)) 

会 创建 : 


subplot2qrid 


BEEN 
| 
m 


GridSpec 和 SubplotSpec 





你 可 以 显 式 创建 cridspec 并 用 它们 创建 子 图 。 
例如 ， 


ax = plt.subplot2grid((2,2),(0, 0)) 


等 价 于 : 


import matplotlib.gridspec as gridspec 
gs = gridspec.GridSpec(2, 2) 
ax = plt.subplot(gs[0, 0]) 


gridspec 示例 提供 类 似 数 组 (一 维 或 二 维 ) 的 索引 ， 并 返回 SubplotSpec X 
例 。 例 如 ， 使 用 切片 来 返回 跨越 多 个 格子 的 SubplotSpec 实例 。 


上 面 的 例子 会 变 成 : 


gs = gridspec.GridSpec(3, 3) 


ax1 = plt.subplot(gs[Oo, :]) 
ax2 = plt.subplot(gs[i,:-1]) 
ax3 = plt.subplot(gs[i:, -1]) 
ax4 = plt.subplot(gs[-1,0]) 
ax5 = plt.subplot(gs[-1,-2]) 


GridSpec 


: ax z 





axl 
ax3 
_ t 


调整 GridSpec 布局 


在 显 式 使 用 GridSpec 的 时 候 ， 你 可 以 调整 子 图 的 布局 参数 ， 子 图 
由 gridspec 创建 。 


gsi = gridspec.GridSpec(3, 3) 
right=0.48, wspace=0.05) 


gsi.update(leftz60.05, 


这 类 似 于 subplots adjust 


下 面 的 代码 


' 但 是 他 只 


gsi = gridspec.GridSpec(3, 3) 
right=0.48, wspace=0.05) 
plt.subplot(gsi[:-1, :]) 
plt.subplot(gsi[-1, :-1]) 
plt.subplot(gsi[-1, -1]) 


gsi.update(leftz60.05, 


axi 
ax2 
ax3 


gridspec.GridSpec(3, 3) 
right=0.98, hspace=0.05) 
plt.subplot(gs2[:, :-1]) 
plt.subplot(gs2[:-1, -1]) 
plt.subplot(gs2[-1, -1]) 


axe 


.update(left=0.55, 


2 


SR 


响 从 给 定 GridSpec 创建 的 子 图 。 


GridSpec w/ different subplotpars 


axl 


ax3 


ax4 





使 用 SubplotSpec 创建 GridSpec 


你 可 以 从 SubplotSpec 创建 GridSpec ， 其 中 它 的 布局 参数 设置 为 给 
定 SubplotSpec 的 位 置 的 布局 参数 。 


gsO = gridspec.GridSpec(i, 2) 


gs00 = gridspec.GridSpecFromSubplotSpec(3, 3, subplot_spec=gs0[0 


gs01 = gridspec.GridSpecFromSubplotSpec(3, 3, subplot_spec=gs0[ 1 


GirdSpec Inside GridSpec 


axl ax 


ax4 


ax z ax3 axo 


使 用 subplotspec 创建 复杂 裔 和 套 的 GridSpec 


ix WA —^43 ARRA gridspec 的 示例 ， 我 们 通过 在 每 个 3x3 内 部 网 格 中 隐 


藏 适当 的 春 线 ， 在 4x4 外 部 网 格 的 每 个 单元 格 周围 放置 一 个 框 。 


使 用 GridSpec 目 定 义 子 图 位 置 





网 格 尺寸 可 变 的 eridspec 


Wi * GridSpec 创建 大 小 相等 的 网 格 。 你 可 以 调整 行 和 列 的 相对 高 度 和 宽度 ， 要 
注意 绝对 高 度 值 是 无 意义 的 ， 有 意义 的 只 是 它们 的 相对 比值 。 


gs = gridspec.GridSpec(2, 2, 
width_ratios=[1,2], 
height_ratios=[4,1] 
) 


ax1 = plt.subplot(gs[90]) 
ax2 = plt.subplot(gs[i]) 
ax3 = plt.subplot(gs[2]) 
ax4 = plt.subplot(gs[3]) 
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原文 : Tight Layout guide 
译 者 : 飞龙 
协议 : CC BY-NC-SA 4.0 


tight layout 会 自动 调整 子 图 和 参数， 使 之 卉 充 整 个 图 像 区 域 。 这 是 个 实验 特 


~ 


ME > PRE A LEILA o Chh AEEA > AA A A A An gR 


分 。 
简单 的 示例 


在 matplotlib 中 ， 轴 域 (包括 子 图 ) 的 位 
是 ， 你 的 轴 标 签 或 标题 (有 了 时 甚至 是 刻度 


置 以 标准 化 图 形 坐 标 指 定 。 可 能 发 生 的 
标签 ) 会 超出 图 形 区 域 ， 因 此 被 截断 。 


plt.rcParams['savefig.facecolor'] = "0.8" 


def example plot(ax, fontsize-12): 


ax. 
ax. 
ax. 
ax. 
ax. 


plot([i, 2]) 

locator params(nbins-3) 

set xlabel('x-label', fontsize-fontsize) 
set ylabel('y-label', fontsize-fontsize) 
set title('Title', fontsize-fontsize) 


plt.close('all') 


fig, ax 


example 


= plt.subplots() 
plot(ax, fontsize-z24) 


Title 


2.0 


1.5 


y-label 


1.0 
0.0 0.5 
¥-lahal 
为 了 避免 它 ， 轴 域 的 位 置 需要 调整 。 对 于 子 图 ， 这 可 以 通过 调整 子 图 参数 (移动 轴 
域 的 一 条 边 来 给 刻度 标签 膳 地 方 ) 。Matplotlib v1.1 引入 了 一 个 新 的 命 


令 tight layout() ， 目 动 为 你 解决 这 个 问题 。 


1.0 


plt.tight layout() 


Title 


2.0 
U 
23 
(O 1.5 
ra 

1.0 

0.0 0.5 1.0 
x-label 


当 你 拥有 多 个 子 图 时 ， 你 会 经 第 看 到 不 同 轴 域 的 标签 王 在 一 起 。 


plt.close('all') 
fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(nrows=2, ncols=2) 
example plot(axi) 
example plot(ax2) 
example plot(ax3) 
example plot(ax4) 
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tight layout() 也 会 调整 子 图 之 间 的 间隔 来 减少 堆 登 。 


Title Title 
2.0 j 


y-label 
k 2 
e un 
y-label 
IP m KJ 
e un = 


1.0 0.0 0.5 1.0 
x-label x-label 
Title Title 
2.0 


y-label 
I I2 
e un 
y-label 
H H N 
o Un O 


0.0 0.5 1.0 


0.0 0.5 1.0 
x-label 


x-label 
tight layout() 可 以 接受 关键 字 参 数 pad ^ w pad 或 者 h pad * X 
图 像 边 界 和 子 图 之 间 的 额外 边 距 。 边 距 以 字体 大 小 单位 规定 。 


plt.tight layout(pad-0.4, w pad=0.5, h_pad=1.0) 


Title Title 


yaang 








0.5 1.0 
x-label x-label 
Title Title 
D 
=| 
U 
- 
0.0 0.5 1.0 0.0 0.5 1.0 
x-label x-label 


即使 子 图 大 小 不 同 ， tight layout() 也 能 够 工作 ， 只 要 网 格 的 规定 的 兼容 的 。 
在 下 面 的 例子 中 ， ax1 和 ax2 是 2x2 网 格 的 子 图 ， 但 是 ax3 是 1x2 网 格 。 


plt.close('all') 
fig - plt.figure() 


ax1 = plt.subplot(221) 
ax2 = plt.subplot(223) 
ax3 = plt.subplot(122) 


example plot(ax1i) 
example plot(ax2) 
example plot(ax3) 


plt.tight layout() 
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y-label 
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x-label 


它 适 用 于 使 用 subplot2grid() 创建 的 子 图 。 一 般 来 说 ， 从 gridspec (1% 
用 Gridspec 自 定义 子 布 局 的 位 置 ) 创建 的 子 图 也 能 正 第 工作 。 


plt.close('all') 


fig - plt.figure() 

ax1 = plt.subplot2grid((3, 
ax2 = plt.subplot2grid((3, 
ax3 = plt.subplot2grid((3, 
ax4 = plt.subplot2grid((3, 


example plot(ax1) 
example plot(ax2) 
example plot(ax3) 
example plot(ax4) 


plt.tight layout() 


3), 
3), 
3), 
3), 


0)) 

1), colspan=2) 

0), colspan=2, rowspan-2) 
2), rowspan=2) 
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x-label x-label 
虽然 没有 彻底 测试 ， 它 看 起 来 也 适用 于 aspect 不 为 auto HUTA (例如 带 有 图 
像 的 轴 域 ) o 


arr = np.arange(100).reshape((10,10)) 


plt.close('all') 
fig = plt.figure(figsize=(5,4)) 


ax 


plt.subplot(111) 
im 


ax.imshow(arr, interpolation="none" ) 


plt.tight layout() 


BB BAR 2) BAL 





pra 
Ex A 


e tight layout() 只 考虑 刻度 标签 ， 轴 标签 和 标题 。 因此 ， 其 他 艺术 家 可 能 
FRAY BT FH LAL] Ae E Bo 

e 它 假定 刻度 标签 ， 轴 标签 和 标题 所 需 的 额外 空间 与 轴 域 的 原始 位 置 无 关 。 这 通 
第 是 丨 的 ， 但 在 军 见 的 情况 下 不 是 。 

e pad = 0 将 茶 些 文本 剪 切 几 个 像素 。 这 可 能 是 当前 算法 的 错误 或 限制 ， 并 且 
不 清楚 为 什么 会 发 生 。 同时 ， 推 荐 使 用 至 少 大 于 0.3 的 间隔 。 


和 GridSpec 一 起 使 用 


GridSpec 拥有 自己 的 tight layout() 方法 (pyplot API 
的 tight layout() 也 能 生效 ) 。 
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plt.close('all') 
fig - plt.figure() 


import matplotlib.gridspec as gridspec 


gsi = gridspec.GridSpec(?2, 1) 
ax1 = fig.add subplot(gsi[9]) 
ax2 = fig.add subplot(gsi[:]) 


example plot(axi) 
example plot(ax2) 


gsi.tight layout(fig) 


Title 
2.0 
E 
w 1.5 
—- 
1.0 
0.0 0.5 1.0 
x-label 
Title 
2.0 
ET 
P 1.5 
L, 
1.0 
0.0 0.5 1.0 
x-label 


你 可 以 提供 一 个 可 选 的 rect 参数 ， 指 定子 图 所 填充 的 边框 。 坐标 必须 为 标准 化 
AA AiR > RUMBA (0, 0, 1, 1) o 


gsi.tight layout(fig, rect=[9, 0, 0.5, 1]) 


BR EX Ap Fy AL AFL 





例如 ， 这 可 用 于 带 有 多 个 gridspecs 的 图 形 。 


gs2 = gridspec.GridSpec(3, 1) 
for ss in gs2: 
ax = fig.add_subplot(ss) 
example_plot(ax) 
ax.set_title("") 
ax.set xlabel("") 
ax.set xlabel("x-label", fontsize-12) 


gs2.tight layout(fig, rect-[0.5, ©, 1, 1], h_pad=0.5) 
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我 们 可 以 尝试 匹配 两 个 网 格 的 顶部 和 底部 。 


top = min(gsi.top, gs2.top) 
bottom = max(gsi.bottom, gs2.bottom) 


gsi.update(top-top, bottom-bottom) 
gs2.update(top-top, bottom-bottom) 


BARLARI o PHS Fe RS] AeL RS hspace 9» 为 了 更 

新 hspace 和 vspace ， 我 们 再 次 使 用 更 新 后 的 rect 参数 调 

用 tight layout() 9 注意 ， rect 参数 指定 的 区 域 包括 刻度 标签 。 因 此 ， 我 们 
将 底部 (正常 情况 下 为 0) 增加 每 个 gridspec 的 底部 之 差 。 顶部 也 一 样 。 


top = min(gsi.top, gs2.top) 
bottom = max(gsi.bottom, gs2.bottom) 


gsi.tight layout(fig, rect=[None, © + (bottom-gsi.bottom), 
0.5, 1 - (gsi.top-top) | ) 
gs2.tight layout(fig, rect-[0.5, © + (bottom-gs2.bottom), 
None, 1 - (gs2.top-top)], 
h_pad=0.5) 
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和 AxesGridi 一 起 使 用 
虽然 受 限 但 也 支持 axes gridi 工具 包 


plt.close('all') 
fig - plt.figure() 


from mpl toolkits.axes gridi import Grid 
grid = Grid(fig, rect=111, nrows_ncols=(2,2), 
axes pad=0.25, label mode= L ， 
) 


for ax in grid: 


example plot(ax) 
ax.title.set visible(False) 


plt.tight layout() 
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颜色 条 


如 果 你 使 用 colorbar 命令 创建 了 颜色 条 ， 创 建 的 颜色 条 是 Axes 而 不 
是 Subplot 的 实例 ， 所 以 tight layout 没有 效果 。 在 Matplotlib v1.1 中 ， 你 可 
以 使 用 gridspec 将 闫 色 条 创建 为 子 图 。 


plt.close('all') 

arr = np.arange(100).reshape((10,10)) 

fig = plt.figure(figsize=(4, 4)) 

im = plt.imshow(arr, interpolation-' none") 


plt.colorbar(im, use gridspec-Tirue) 


plt.tight layout() 


![Dhttp://matplotlib.org/ images/tight layout guide-14.png 


另 一 个 选项 是 使 用 AxesGrid1 工具 包 ， 显 式 为 闫 色 条 创建 一 个 轴 域 : 


BB BAR 2) BAL 


plt.close('all') 

arr np.arange(100).reshape((10,10)) 

fig plt.figure(figsize=(4, 4)) 

im = plt.imshow(arr, interpolation-" none") 


from mpl toolkits.axes gridi1 import make axes locatable 
divider = make axes locatable(plt.gca()) 

cax = divider.append axes("right", "5%", pad="3%"') 
plt.colorbar(im, cax=cax) 


plt.tight layout() 








or 


a L e 
MEE EE 
原文 : Artist tutorial 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


matplotlib API 有 三 个 层级 。 matplotlib.backend_bases.FigureCanvas 是 绘 
制图 形 的 区 域 ， matplotlib.backend bases.Renderer 是 知道 如 何 

在 ChartCanvas 上 绘制 的 对 象 ， 而 matplotlib.artist.Artist 是 知道 如 何 使 
用 泻 染 器 在 画布 上 画图 的 对 象 。 FigureCanvas 和 Renderer 处 理 与 用 户 界 面 工 
具 包 (如 wxPython) 或 PostScript@ 等 绘图 语言 交互 的 所 有 细节 ， Artist 处 理 
所 有 高 级 结构 ， 如 表示 和 布局 图 形 ， 文 本 和 线条 。 用 户 通 第 要 花费 95290 的 时 间 来 处 
理 艺 术 家 。 

有 两 种 类 型 的 艺术 家 : 基本 类 型 和 容器 类 型 。 基 本 类 型 表示 我 们 想 要 绘制 到 画布 上 
的 标准 图 形 对 象 : Line2D * Rectangle ， Text ， AxesImage 等 ， 容 器 是 放 
置 它们 的 位 置 ( Axis > Axes 和 Figure ) 。 标 准 用 法 是 创建 一 个 Figure X 
例 ， 使 用 Figure 创建 一 个 或 多 个 Axes 或 Subplot 实例 ， 并 使 用 Axes 实例 
的 辅助 方法 来 创建 基本 类 型 。 在 下 面 的 示例 中 ， 我 们 使 

用 matplotlib.pyplot.figure() 创建 一 个 Figure 实例 ， 这 是 一 个 便捷 的 方 
法 ， 用 于 实例 化 Figure 实例 并 将 它们 与 你 的 用 户 界 面 或 绘图 工具 

包 FigureCanvas 连接 。 正 如 我 们 将 在 下 面 讨论 的 ， 这 不 是 必须 的 - 你 可 以 直接 使 
用 PostScript > PDF > Gtk+ 或 wxPython FigureCanvas 实例 ， 直 接 实例 化 你 的 
图 形 并 连接 它们 - 但 是 因为 我 们 在 这 里 关注 艺术 家 API， 我 们 让 pyplot 为 我 们 处 
理 一 些 细节 : 


import matplotlib.pyplot as plt 
fig - plt.figure() 
ax = fig.add subplot(2,1,1) # lo rows, one ， 


Axes 可 能 是 matplotlib API 中 最 重要 的 类 ， 你 将 在 大 多 数 时 间 使 用 它 。 这 是 因 
A Axes 是 大 多 数 对 象 所 进入 的 绘图 区 域 ， Axes 有 许多 特殊 的 辅助 方法 

( plot() * text() * hist() ， imshow() ) 来 创建 最 常见 的 图 形 基 本 类 型 
Line2D ^ Text ， Rectangle > Image ) 。 这 些 辅助 方法 将 获取 你 的 数据 
(例如 numpy 数组 和 字符 串 ) ， 并 根据 需要 创建 基本 Artist 实例 〈 例 

如 ，Line2D ) ， 将 它们 添加 到 相关 容器 中 ， 并 在 请 求 时 绘制 它们 。 大 多 数 人 可 
ALAA SA RR Axes 的 一 个 特例 ， 它 存在 于 Subplot 实例 的 列 网 格 的 固定 
行 上 。 如 果 要 在 任意 位 置 创建 Axes ， 只 需 使 用 add axes() FH? BAKE 
5t [left, bottom, width, height] 值 的 列表 ， 以 0~1 的 图 形 相 对 坐标 为 单 


位 : 


fig2 = plt.figure() 
ax2 = fig2.add axes([0.15, 0.1, 0.7, 0.3]) 


以 我 们 的 例子 继续 : 


import numpy as np 

t - np.arange(0.0, 1.0, 0.01) 

s = np.sin(2*np.pi*t) 

line, = ax.plot(t, s, color-'blue', lw=2) 


在 这 个 例子 中 ， ax 是 上 面 的 fig.add subplot 调用 创建 的 Axes 实例 〈 记 
f£ subplot 只 是 Axes 的 一 个 子 类 ) ， 当 你 调用 ax.plot 时 ， 它 创建 一 

个 Line2D 实例 并 将 其 添加 到 Axes.lines 列表 中 。 在 下 面 的 ipython 交互 式 会 
话 中 ， 你 可 以 看 到 Axes.lines 列表 的 长 度 为 1， 并且 包 含 

由 line, - ax.plot... 调用 返回 的 相同 线条 : 


In [101]: ax.lines[0] 
Out[101]: «matplotlib.lines.Line2D instance at 0x19a95/10> 


In [102]: line 
Out[102]: «matplotlib.lines.Line2D instance at 0x19a95/10> 


如 果 你 对 ax.plot 卖 调用 (并 且 保 持 状态 为 『on」 ， 这 是 默认 值 ) ， 则 将 
在 列表 中 添加 其 他 线条 。 你 可 以 稍 后 通过 调用 列表 方法 删除 线条 ; 任何 一 个 方法 都 
"TA: 


del ax.lines[0] 
ax.lines.remove(line) 


轴 域 也 拥有 辅助 方法 ， 用 于 设置 和 装饰 fo y 轴 的 刻度 、 刻 度 标 签 和 轴 标 签 : 


ax.set xlabel('my xdata' ) 
ax.set ylabel('my ydata') 


xtext 
ytext 


ye 调用 ax.set xlabel 时 ， 它 将 信息 传递 给 XAxis 的 Text 实例 ， 
个 Axes 实例 都 包含 XAxis 和 YAxis ， 它 们 处 理 刻度 、 刻 度 标 签 的 布 
局 和 给 会 制 。 


尝试 创建 下 面 的 图 形 : 


a sine wave 


volts 








自 定义 你 的 对 象 


图 中 的 每 个 元 素 都 由 一 个 matplotlib 艺术 家 表示 ， 每 个 元 素 都 有 一 个 扩展 属性 列表 
用 于 配置 它 的 外 观 。 图 形 本 身 包 含 一 个 Rectangle ， 正 好 是 图 形 的 大 小 ， 你 可 以 
使 用 它 来 设置 图 形 的 背景 凑 色 和 透明 度 。 同样 ， 每 个 Axes 边框 (在 通常 的 
matplotlib 绘图 中 是 标准 的 白 底 黑 边 ) 拥有 一 个 Rectangle 实例 ， 用 于 确定 轴 域 
的 颜色 ， 透 明度 和 其 他 属性 ， 这 些 实 例 存 储 为 成 员 变 

@ Figure.patch 和 Axes.patch ( [Patch] 是 一 个 继承 自 MATLAB 的 名 称 ， 
它 是 图 形 上 的 一 个 颜色 的 2D『 补 本 上 > f|d9 4876 > [le 2 3576 ) 。 每 个 matplotlib 
艺术 家 都 有 以 下 属性 。 


属性 描述 


alpha 透明 度 -0~1 的 标量 

animated ”用 于 帮助 动画 绘制 的 布尔 值 

axes 艺术 家 所 在 的 轴 域 ， 可 能 为 空 
clip box AT 3j a 2, RA WIE 

clip on Bit GH FB 

clip path 艺术 家 被 剪 切 的 路 径 

contains 一 个 拾取 函数 ， 用 于 判断 艺术 家 是 否 位 于 拾取 点 
figure 艺术 家 所 在 的 图 形 实 例 ， 可 能 为 空 
label 文本 标签 (用 于 自动 标记 ) 

picker 控制 对 象 拾 取 的 Python WR 
transform ”变换 

visible 布尔 值 ， 表示 艺术 家 是 否 应 该 绘制 
zorder 确定 绘制 顺序 的 数值 


rasterized A RE’ 是 否 将 向 量 转换 为 光栅 图 形 (出 于 压缩 或 eps 透明 度 ) 


每 个 属性 都 使 用 一 个 老式 的 en 或 getter 《十 的 ， 我 们 知道 这 会 刺激 
Python 爱好 者 ， 我 们 计划 支持 通过 属性 或 traits 直接 访问 ， 但 它 还 没有 完成 ) 。 Bl 
如 ， 要 将 当前 alpha 值 变 为 一 半 : 


a = o.get alpha() 
o.set alpha(0.5*a) 


如 果 你 打算 可 以 一 次 性 设置 一 些 属性 ， 你 也 可 以 以 关键 字 参 数 使 用 set 方法 ， 例 
4n : 


o.set(alpha=0.5, zorder=2) 


如 果 你 在 Python 交互 式 Shell 中 工作 ， 检 查 Artist 属性 的 一 种 方便 的 方法 是 使 
用 matplotlib.artist.getp() X ry pylab 中 只 需要 getp() ) ， 它 列 出 了 
属性 及 其 值 。 这 适用 于 从 Artist 派生 的 类 ， 例 如 Figure 和 Rectangle ° 这 
里 是 上 面 提 到 的 Figure 的 矩形 属性 : 


In [149]: matplotlib.artist.getp(fig.patch) 
alpha = 1.0 
animated = False 
antialiased or aa = True 
axes = None 
clip box - None 
clip on - False 
clip path - None 
contains - None 
edgecolor or ec = w 
facecolor or fc = 0.75 
figure = Figure(8.125x6.125) 


fill - 

hatch - None 
height = 1 
label = 


linewidth or lw = 1.0 

picker = None 

transform = <Affine object at 0x134cca84> 
verts = ((0, 0), (0, 1), (1, 1), (1, 9)) 
visible - True 


width = 1 

window extent = <Bbox object at 0x134acbcc> 
xX = 0 

y= 0 


zorder = 1 


所 有 类 的 文档 字符 串 也 包含 Artist 属性 ， 因 此 你 可 以 查阅 交互 式 『 帮 助 」 了 或 
Artist 模块 ， 来 获取 给 定 对 因 的 属性 列表 。 


对 象 容器 


现在 我 们 知道 如 何 检 查 和 设置 我 们 想 要 配置 的 给 定 对 象 的 属性 ， 现 在 我 们 需要 如 何 
获取 该 对 象 。 前 面 提 到 了 两 种 对 象 : 基本 类 PERAN 。 大 本 类 型 通 第 是 你 想 
要 配置 的 东西 ( Text 实例 的 字体 ， Line2D WRA) ， 虽 然 容器 也 有 一 些 属 | 性 - 
例如 Axes 是 一 个 容器 艺术 家 ， 包 含 你 的 绘 中 的 许多 基本 类 型 ， 但 它 也 有 属 

性 ， 比 如 xscale 来 控制 xaxis 是 线性 」 还 是 『 对 数 」 o 在 本 节 中 ， 我 们 将 回 
顾 各 种 容器 对 人 象 存 储 你 想 要 访问 的 艺术 家 的 位 置 。 


AG R 

顶层 容器 艺术 家 是 matplotlib.figure.Figure ， 它 包含 图 形 中 的 所 有 内 容 。 图 
形 的 背景 是 一 个 Rectangle >? AAE os. wee d 当 你 向 图 形 中 添加 子 
图 ( add subplot() ) 和 轴 域 ( add axes() ) E 这 些 会 附加 


到 Figure.axes » 它们 也 由 创建 它们 的 方法 返回 


In [156]: fig plt.figure() 


In [157]: axi 


fig.add subplot(211) 


In [158]: ax2 


fig.add_axes([0.1, 0.1, 0.7, 0.3]) 


In [159]: axi 
Out[159]: «matplotlib.axes.Subplot instance at 0xd54b26c» 


In [160]: print fig.axes 
[<matplotlib.axes.Subplot instance at 0xd54b26c», «matplotlib.ax 
es.Axes instance at Oxd3f0b2c»] 


因为 图 形 维 护 了 『 当 前 轴 域 ] ( 见 figure.gca 和 图 figure.sca ) 的 概念 以 支 
持 pylab/pyplot 状态 机 ， 所 以 不 应 直接 从 轴 域 列表 中 插入 或 删除 轴 域 ， 而 应 使 

用 add subplot() 和 add axes() 方法 进行 插入 ， 并 使 用 delaxes() 方法 进行 
删除 。 然 而 ， 你 可 以 自由 地 遍历 轴 域 列表 或 索引 ， 来 访问 要 自 定义 的 axes X: 

例 。 下 面 是 一 个 打开 所 有 轴 域 网 格 的 示例 : 


for ax in fig.axes: 
ax.grid(True) 


— 


图 形 还 拥有 自己 的 文本 ， 线 条 ， 补 本 和 图 像 ， 你 可 以 使 用 它们 直接 添加 基本 类 型 。 
图 形 的 默认 坐标 系统 简单 地 以 像素 (这 通常 不 是 你 想 要 的 ) 为 单位 ， 但 你 可 以 通过 
设置 你 添加 到 图 中 的 艺术 家 的 transform 属性 来 控制 它 。 
更 有 用 的 是 『 图 形 坐 标 系 」， 其 中 (0,0) 是 图 的 左下 角 ， (1,1) 是 图 的 右上 
角 ， 你 可 以 通过 将 Artist 的 变换 设置 为 fig.transFigure 来 获得 : 

In [191]: fig = plt.figure() 


In [192]: 11 = matplotlib.lines.Line2D([O, i], [9, 1], 
transform-fig.transFigure, figure-fig) 


In [193]: 12 = matplotlib.lines.Line2D([O, i], [1, ©], 
transform-fig.transFigure, figure-fig) 


In [194]: fig.lines.extend([11, 12]) 


In [195]: fig.canvas.draw() 


这 里 十 图 形 可 以 包含 的 艺术 家 总结 : 


图 形 属 性 描述 
axes Axes 实例 的 列表 (包括 Subplot ) 
patch Rectangle 背景 
images FigureImages 补丁 的 列表 - 用 于 原始 像素 显示 
legends 图 形 Legend 实例 的 列表 (AEF Axes.legends ) 
lines 图 形 Line2D 实例 的 列表 (ARIA > WL Axes.lines ) 
patches 图 形 补 丁 列 表 (很 少 使 用 ， 见 Axes.patches ) 
texts 图 形 Text 实例 的 列表 

轴 域 容器 


matplotlib.axes.Axes  matplotlb 宇宙 的 中 心 - 它 包 含 绝 大 多 数 在 一 个 图 形 
中 使 用 的 艺术 家 ， 并 带 有 许多 辅助 方法 来 创建 和 添加 这 些 艺术 家 本 身 ， 以 及 访问 和 
自 定义 所 包含 的 艺术 家 的 辅助 方法 。 就 像 Figure 那样 ， 它 包含 一 

个 Patch patch ， 它 是 一 个 用 于 笛 卡 尔 坐 标的 Rectangle 和 一 个 用 于 极 坐 标 
的 Cirecle ; 这 个 补丁 决定 了 绘图 区 域 的 形状 ， 背 景 和 边框 : 


= fig.add = dud cond 
Tet = ax.patch # a angle 
rect.set facecolor(' green m 


pieni. 会 图 方法 (例如 通常 是 plot() ) 并 传递 数组 或 值 列 表 时 ， 该 方法 将 创建 一 
个 matplotlib.lines.Line2D() 实例 ， | Line2D 属性 作为 关键 字 参 数 传 
递 ， 将 该 线条 添加 到 Axes.lines 容器 ， 并 将 其 返回 给 你 : 


In [213]: x, y = np.random.rand(2, 100) 


In [214]: line, = ax.plot(x, y, '-', color='blue', linewidth-2) 


plot 返回 一 个 线条 列表 ， 因 为 你 可 以 传 入 多 个 x, y 偶 对 来 绘制 ， 我 们 将 长 度 为 
一 的 列表 的 第 一 个 元 素 解 构 到 line 变量 中 。 该 线条 已 添加 到 Axes.lines 列表 
中 : 


In [229]: print ax.lines 
[<matplotlib.lines.Line2D instance at 0xd378b0c»] 


与 之 类 似 ， 创 建 补丁 的 方法 (如 bar() ) 会 创建 一 个 矩形 列表 ， 将 补丁 添加 
到 Axes.patches 列表 中 : 


In [233]: n, bins, rectangles = ax.hist(np.random.randn(i000), 50 
, facecolor-'yellow') 


In [234]: rectangles 
Out[234]: «a list of 50 Patch objects» 


In [235]: print len(ax.patches) 
[| 


你 不 应 该 和 直接 将 对 象 添 加 到 Axes.lines X Axes.patches 列表 ， 除 非 你 确切 知 
道 你 在 做 什么 ， 因 为 Axes 需要 在 它 创 建 和 添加 对 象 做 一 些 事情 。 它 设 

置 Artist 的 figure 和 axes 属性 ， 以 及 默认 Axes 变换 (除非 设置 了 变 

换 ) o 它 还 检查 Artist 中 包含 的 数据 ， 来 更 新 控制 目 动 缩放 的 数据 结构 ， 以 便 

可 以 调整 视图 限制 来 包含 绘制 的 数据 。 但 是 ， 你 可 以 自己 创建 对 象 ， 并 使 用 辅助 方 
法 (如 add line() 和 add patch() ) 将 它们 直接 添加 到 Axes 。 这 里 是 一 个 

注释 的 交互 式 会 话 ， 说 明正 在 发 生 什 么 


In [261]: fig = plt.figure() 
In [262]: ax = fig.add subplot(111) 


4 create a rectangle instance 
In [263]: rect = matplotlib.patches.Rectangle( (1,1), width=5, h 
eight=12) 


# by default the axes instance is None 
In [264]: print rect.get_axes() 
None 


# and the transformation instance is set to the “identity transf 
orm" 

In [265]: print rect.get transform() 

<Affine object at 0x13695544> 


# now we add the Rectangle to the Axes 
In [266]: ax.add patch(rect) 


4 and notice that the ax.add patch method has set the axes 
# instance 

In [267]: print rect.get axes() 

Axes(0.125,0.1;0.775x0.8) 


# and the transformation has been set too 
In [268]: print rect.get transform() 
«Affine object at 0x15009ca4> 


# the default axes transformation is ax.transData 
In [269]: print ax.transData 
«Affine object at 0x15009ca4> 


4 notice that the xlimits of the Axes have not been changed 
In [270]: print ax.get xlim() 
(OO 0 


# but the data limits have been updated to encompass the rectang 
le 

In [271]: print ax.dataLim.bounds 

(umo rM PELO EC SO T20) 


# we can manually invoke the auto-scaling machinery 
In [272]: ax.autoscale view() 


4 and now the xlim are updated to encompass the rectangle 
In [273]: print ax.get xlim() 
(TOTO 0) 


# we have to manually force a figure draw 
In [274]: ax.figure.canvas.draw() 
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有 非常 多 的 Axes 辅助 方法 用 于 创建 基本 艺术 家 并 将 它们 添加 到 他 们 各 自 的 容器 
中 。 下 表 总 结 了 他 们 的 一 部 分 ， 他 们 创造 的 Artist 的 种 类 ， 以 及 他 们 在 哪里 存 
fh EN © 


辅助 万 法 艺术 家 BS 
ees -XA Annotate ax. texts 
ax.bar - UA Rectangle ax. patches 
ax.errorbar -误差 Line2D 和 ax.lines 和 
条 形 图 Rectangle ax.patches 
ax.fill - 3€ BOX Polygon ax.patches 
ax.hist -直方 图 Rectangle ax.patches 
ax.imshow -图 像 数 据 AxesImage ax.images 
ax.legend - 轴 域 图 例 Legend ax.legends 
ax.plot -xy 绘 Line2D ax.lines 
ax.scatter - XXE PolygonCollection ax.collections 
ax.text -文本 Text ax.texts 


除了 所 有 这 些 艺术 家 ， Axes eS 含 两 个 重要 的 艺术 家 容器 : XAxis 和 YAxis ， 
eh al BRIE 的 绘制 。 它们 被 存储 为 实例 变量 xaxis 和 yaxis o 

XAxis 和 YAxis 容器 将 在 下 面 详细 介绍 ， 但 请 注意 ， Axes 包含 许多 辅助 方 
法 ， 它 们 会 将 调用 转发 给 Axis 实例 ， 因 此 你 通 第 不 需要 直接 使 用 它们 ， 除 非 你 愿 
so 例如 ， 你 可 以 使 用 Axes 辅助 程序 方法 设置 XAxis 刻度 标签 的 字体 大 小 : 


for label in ax.get xticklabels(): 
label.set color('orange') 


下 面 是 轴 域 所 包含 的 艺术 家 的 总 结 


轴 域 属性 描述 


artists Artist 实例 的 列表 

patch 用 于 轴 域 背景 的 Rectangle 实例 

collections Collection 实例 的 列表 

images AxesImage 的 列表 

legends Legend 实例 的 列表 

lines Line2D 实例 的 列表 

patches Patch 实例 的 列表 

texts Text 实例 的 列表 

xaxis matplotlib.axis.XAxis 实例 

yaxis matplotlib.axis.YAxis 实例 
Ih 25. 28 


matplotlib.axis.Axis 实例 处 理 刻度 线 ， 网 格 线 ， 刻 度 标 签 和 轴 标 签 的 绘制 。 
你 可 以 分 别 为 y 轴 配置 左 和 右 刻 度 ， 为 X 轴 分 别 配置 上 和 下 刻度 。 Axis 还 存储 在 
自动 缩放 ， 平 移 和 缩放 中 使 用 的 数据 和 视图 间隔 ， 以 

及 Locator 和 Formatter 实例 ， 它 们 控制 刻度 位 置 以 及 它们 表示 为 字符 串 的 方 
AS 


每 个 Axis 对 象 都 包含 一 个 label 属性 (这 是 pylab 在 调 

用 xlabel() 和 ylabel() 时 修改 的 东西 ) 以 及 主 和 次 刻度 的 列表 。 刻 度 

是 XTick 和 YTick 实例 ， 它 包含 浑 染 刻 度 和 刻度 标签 的 实际 线条 和 文本 基本 类 
型 。 因 为 刻度 是 按 需 动态 创建 的 (例如 ， 当 平移 和 缩放 时 ) ， 你 应 该 通过 访问 器 方 
法 get major ticks() 和 get minor ticks() 访问 主 和 次 刻度 的 列表 。 虽 然 刻 
度 包 含 所 有 下 面 要 提 及 的 基本 类 型 Axis 方法 包含 访问 器 方法 来 返回 刻度 线 ， 刻 
度 标签 ， 刻 度 位 置 等 : 


In [285]: axis = ax.xaxis 


In [286]: axis.get ticklocs() 
Ou Z86 |e array Dc TT a 9-45 yp 8 9 
]) 


In [287]: axis.get ticklabels() 
Out[287]: «a list of 10 Text major ticklabel objects» 


4 note there are twice as many ticklines as labels because by 

4 default there are tick lines at the top and bottom but only t 
ick 

4 labels below the xaxis; this can be customized 

In [288]: axis.get ticklines() 

Out[288]: «a list of 20 Line2D ticklines objects» 


# by default you get the major ticks back 
In [291]: axis.get ticklines() 
Out[291]: «a list of 20 Line2D ticklines objects» 


# but you can also ask for the minor ticks 
In [292]: axis.get_ticklines(minor=True) 
Out[292]: «a list of 0 Line2D ticklines objects» 


ng 


下 面 是 Axis 的 一 些 有 用 的 访问 器 方法 的 总 结 (它们 拥有 相应 的 setter ， 
如 set major formatter ) » 


| 2 Zr iA 
get scale 
get view interval 
get data interval 
get gridlines 
get label 
get ticklabels 
get ticklines 


get ticklocs 


get major locator 


get major formatter 


get minor locator 


get minor formatter 
get major ticks 
get minor ticks 


grid 


描述 

轴 的 比例 ， 例 如 'log' 或 'linear' 

轴 视 图 范围 的 内 部 实例 

轴 数 据 疙 围 的 内 部 实例 

轴 的 网 格 线 列表 

ange - Text 实例 
Text 实例 的 列表 - 关键 字 `minor=True 
Line2D 实例 的 列表 - 关键 字 `minor=True 
Tick 位 置 的 列表 - 关键 字 `minor=True 


用 于 主 刻度 
的 matplotlib.ticker.Locator 实例 


RT zal Ee 
的 matplotlib.ticker.Formatter 实例 


用 于 次 刻度 
的 matplotlib.ticker.Locator 实例 


FF RAI PE 
的 matplotlib.ticker.Formatter 实例 


用 于 主 刻 度 的 Tick 实例 列表 
用 于 次 刻度 的 Tick 实例 列表 
为 主 或 次 刻度 打开 或 关闭 网 格 


这 里 是 个 例子 ， 出 于 美观 不 太 推荐 ， 它 自 定 义 了 轴 域 和 刻度 属性 。 


False 
False 


False 


import numpy as np 
import matplotlib.pyplot as plt 


# plt.figure creates a matplotlib.figure.Figure instance 
fig - plt.figure() 

rect = fig.patch # a rectangle instance 

rect.set facecolor('lightgoldenrodyellow') 


ax1 = fig.add_axes([0.1, 0.3, 0.4, 0.4]) 
rect = axi1.patch 
rect.set_facecolor('lightslategray' ) 


for label in ax1.xaxis.get_ticklabels(): 
# label is a Text instance 
label.set_color('red' ) 
label.set_rotation(45) 
label.set_fontsize(i6) 


for line in axi.yaxis.get ticklines(): 
# line is a Line2D instance 
line.set color('green') 
line.set_markersize(25) 
line.set_markeredgewidth(3) 


plt.show( ) 





* © 
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matplotlib.axis.Tick 十 我 们 从 Figure 到 Axes 再 到 Axis 再 到 Tick 的 


最 终 的 容器 对 象 。 


Tick 包含 刻度 和 网 格 线 的 实例 ， 以 及 上 侧 和 下 侧 刻 度 的 标签 实 


例 。 每 个 都 可 以 直接 作为 Tick 的 属性 访问 。 此 外 ， 也 有 用 于 确定 上 标签 和 刻度 
是 否 对 应 x 轴 ， 以 及 右 标 签 和 刻度 是 否 对 应 y 轴 的 布尔 变量 。 


刻度 属性 描述 
tickiline Line2D 实例 
tick2line Line2D 实例 
gridline Line2D 实例 
label1 Text 实例 
label2 Text 实例 
gridon 确定 是 否 绘制 刻度 线 的 布尔 值 
tick10n 确定 是 否 绘 制 主 刻度 线 的 布尔 值 
tick20n 确定 是 否 绘制 次 刻度 线 的 布尔 值 
labeliOn 确定 是 否 绘 制 主 刻度 标签 的 布尔 值 


label20n 确定 


Fe 
这 里 是 个 例子 ， 使 用 美元 符号 设置 右 侧 刻度 ， 并 在 y 轴 右 侧 将 它们 设 成 绿色 。 


import numpy as np 
import matplotlib.pyplot as plt 
import matplotlib.ticker as ticker 














# Fixing random state for reproducibility 
np.random.seed(19680801) 





























fig - plt.figure() 
ax = fig.add subplot(111) 
ax.plot(i00*np.random.rand(20) ) 


formatter = ticker.FormatStrFormatter('$%1.2f') 
ax.yaxis.set_major_formatter(formatter ) 


for tick in ax.yaxis.get_major_ticks(): 
tick.label10n = False 
tick.label20n = True 


tick.label2.set color('green') 


plt.show() 
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图 例 指 南 


原文 : Legend guide 
译 者 : 飞龙 
Wi : CC BY-NC-SA 4.0 


此 图 例 指南 是 legend() 中 可 用 文档 的 扩展 - 请 在 继续 阅读 本 指南 之 前 确保 你 熟悉 
该 文档 〈 见 篇 尾 ) 的 内 容 。 


本 指南 使 用 一 些 第 见 术语 ， 为 了 清楚 起 见 ， 这 些 术 语 在 此 处 进行 说 明 : 
E p] & B 

图 例 由 一 个 或 多 个 图 例 条 目 组 成 。 一 个 条 目 由 一 个 键 和 一 个 标签 组 成 。 
图 例 键 

每 个 图 例 标签 左 侧 的 彩色 /图 案 标记 。 

E | zs 

45 ak d] AER R AY 6] d BY SCA o 

图 例 6] 49 

用 于 在 图 例 中 生成 适当 条 目的 原始 对 象 。 


控制 图 例 条 目 
不 带 参数 调用 legend() 会 自动 获取 图 例句 柄 及 其 相关 标签 。 此 函数 等 同 于 : 


handles, labels = ax.get legend handles labels() 
ax.legend(handles, labels) 


get legend handles labels() HAA E 3X E f£ 8)6d8/ T, A RANA ”? 

些 名 柄 /艺术 家 可 以 用 于 为 结果 图 例 生 成 条 目 - 但 值得 注意 的 是 ， 并 非 所 有 
可 以 添加 到 图 例 中 ， 这 种 情况 下 会 创建 了 代理 上 (请 参阅 特地 为 添加 到 图 例 创 建 艺 
AX (也 称 为 代理 艺术 家 ) ， 来 了 解 更 多 详细 信息 ) 。 


为 了 完全 控制 要 添加 到 图 例 的 内 容 ， 通 第 将 适当 的 匈 柄 直接 传递 给 legend() 
line up, = plt.plot([1,2,3], label='Line 2') 


line down, - plt.plot([3,2,1], label-'Line 1') 
plt.legend(handles-[line up, line down]) 


在 某 些 情况 下 ， 不 可 能 设置 句柄 的 标签 ， 因 此 可 以 将 标签 列表 传递 给 legend() 


line up, = plt.plot([1,2,3], label-'Line 2 ) 
line down, = plt.plot([3,2,31], label-' Line 1') 
plt.legend([line up, line down], [' Line Up', ‘Line Down']) 


特地 为 添加 到 图 例 创 建 艺术 家 (也 称 为 代理 艺术 家 ) 


并 非 所 有 的 句 枉 都 可 以 自动 转换 为 图 例 条 目 ， 因 此 通常 需要 创建 一 个 可 转换 的 艺术 
家 。 图 例 匈 柄 不 必 存 在 于 被 用 到 的 图 像 或 轴 域 上 。 


假设 我 们 想 创 建 一 个 图 例 ， 其 中 有 一 些 数据 表示 为 红色 : 


import matplotlib.patches as mpatches 
import matplotlib.pyplot as plt 


red patch = mpatches.Patch(color='red', label-'The red data') 
plt.legend(handles-[red patch]) 


plt.show() 


ENN The red data 
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线条 : 


import matplotlib.lines as mlines 
import matplotlib.pyplot as plt 


blue line = mlines.Line2D([], [], color='blue', marker='*', 
markersize-15, label-'Blue stars') 


plt.legend(handles-[blue line]|) 


plt.show() 


图 例 位 置 


图 例 的 位 置 可 以 通过 关键 字 参 数 loc 指定 。 详细 信息 请 


bbox to anchor 关键 宁可 让 用 户 手 动 控制 图 例 A Fa} ° 


参阅 legend() 的 文档 。 
例如 ， 如 果 你 硕 望 轴 域 图 


例 位 于 图 像 的 右上 月 而 不 是 轴 域 的 边 月 ， 则 只 需 指 定 角 的 位 置 以 及 该 位 置 的 坐标 


IJ e 


plt.legend(bbox_to_anchor=(i1, 1), 


bbox_transform=plt.gcf().transFigure) 


目 定 义 图 例 位 置 的 更 多 示例 : 


import matplotlib.pyplot as plt 


plt.subplot(211) 
plt.plot([1,2,3], label="testi") 
s qose 


~、 Y A La 2 了 Ge » ) ey lo T ry?) N} CF7 Yr 
+ Ap PEE PKA jt |] T AM 853 Z7 AE 
A | J- As 个 | | A KE 二 
V / J J/N 


a to Teacher: (0., OZ dp S gc, 
ncol-2, mode="expand", borderaxespad=0. ) 


plt . subplot (223) 
plt.plot([1,2,3], label="test1") 
plt.plot([s, 2 A Tabel- T enD 
H JZ R 1| 3 E 


ur iue m d to anor (1.05, 1), loc=2, borderaxespad=0. ) 


plt.show( ) 


—— testi — fest? 
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3.0 一 一 test 


—— test? 
2.9 


2.0 
1.5 
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相同 轴 域 内 的 多 个 图 例 


有 时 ， 在 多 个 图 例 之 间 分 割 图 例 条 目 会 更 加 清晰 。 虽然 直觉 上 的 做 法 可 能 是 多 次 调 
用 legend() 元 数 ， 但 你 会 发 现 轴 域 上 只 存在 一 个 图 例 。 这 样 做 是 为 了 可 以 重复 
调用 legend() ， 将 图 例 更 新 为 轴 域 上 的 最 新 句柄 ， 因 此 要 保留 日 的 图 例 实 例 ， 我 


们 必须 将 它们 手动 添加 到 轴 域 中 : 


import matplotlib.pyplot as plt 


linei, 
line2, 


plt.plot([1,2,3], label="Line 1", linestyle-'--') 
plt.plot([3,2,1], label="Line 2", linewidth=4) 


# 为 第 一 个 线条 创建 图 例 
first legend = plt.legend(handles-[linei1], loc-i) 


# 手动 将 图 例 添 加 到 当前 轴 域 
ax = plt.gca().add artist(first legend) 


# 为 第 二 个 线条 创建 另 一 个 图 例 
plt.legend(handles-[line2], loc-4) 


plt.show() 


-—- Line l 
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为 了 创建 图 例 条 目 ， 将 句柄 作为 参数 提供 给 适当 的 HandlerBase 子 类 。 AES 
类 的 选择 由 以 下 规则 确定 : 


e 使 用 handler map 关键 字 中 的 值 更 新 get legend handler map() 。 
e 检查 句柄 是 否 在 新 创建 的 handler map 中 。 

e 检查 名 柄 的 类 型 是 否 在 新 创建 的 handler map ¥ ° 

e #241489 mro 中 的 任何 类 型 是 否 在 新 创建 的 handler map 中 。 


处 于 完整 性 ， 这 个 逻辑 大 多 在 get legend handler() 中 实现 。 
所 有 这 些 灵 活性 意味 着 我 们 可 以 使 用 一 些 必 要 的 钧 子 ， 为 我 们 自己 的 图 例 键 类 型 实 
现 自 定义 处 理 器 。 


使 用 自 定义 处 理 器 的 最 简单 的 例子 是 ， 实 例 化 一 个 现 有 的 HandlerBase 子 类 。 A 
了 简单 起 见 ， 让 我 们 选择 matplotlib.legend handler.HandlerLine2D ， 它 接 
5t numpoints 参数 (出 于 便利 ， 注 意 numpoints Æ legend() 函数 上 的 一 个 关 
RF) 。 然后 我 们 可 以 将 实例 的 字典 作为 关键 字 handler_map 传 给 legend 。 


import matplotlib.pyplot as plt 
from matplotlib.legend handler import HandlerLine2D 


linei, 
line2, 


plt.plot([3,2,1], marker-z'o', label-'Line 1') 
plt.plot([1,2,3], marker='o', label='Line 2') 


plt.legend(handler map-[linei: HandlerLine2D(numpoints=4 )}) 


eene Line 1 


—@ Line 2 
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如 你 所 见 ， Line 1 现在 有 4 个 标记 点 ， Line 2 有 两 个 (默认 值 ) 。 尝试 上 面 
的 代码 ， 只 需 将 字典 的 键 从 linei 更 改 为 typelline) 。 注意 现在 两 个 Line2D 实例 
都 拥有 了 4 个 标记 。 


除了 用 于 复杂 的 绘图 类 型 的 处 理 器 ， 如 误差 条 ， 茶 叶 图 和 直方 图 ， 默 认 

的 ] handler_map 有 一 个 特殊 的 元 组 处 理 器 ( HandlerTuple ) ， 它 简单 地 在 顶部 
一 一 绘制 给 定 元 组 中 每 个 项 目的 勿 柄 。 以 下 示例 演示 如 何 将 两 个 图 例 的 键 相互 三 
jm: 


import matplotlib.pyplot as plt 
from numpy.random import randn 


z = randn(i0) 
Met. oot = Ry D PUE markersize=15) 


cee _cross, 3 DIU BEER 5], "w+", markeredgewidth=3, 
ze-15) 


plt.legend([red dot, (red dot, white cross)], ["Attr A", 
*B"]) 


? Attr A 
15 | qp Attr A+B 





3: 3À, Ae 3L EL P] AE XE ES 


TAKA LAS > HE 6 8 RA AE ( 外 柄 不 必要 


是 matplotlib artist) » AA LAEM legend artist 方法 ， 该 方法 为 要 使 


用 的 图 例 返回 单个 艺术 家 « 有 关 legend_artist 的 详细 信息 ， 请 参 
I| legend artist() ° 


import matplotlib.pyplot as plt 
import matplotlib.patches as mpatches 


class AnyObject(object): 
pass 


class AnyObjectHandler(object ): 
def legend artist(self, legend, orig handle, fontsize, handl 
ebox): 











x0, yO - handlebox.xdescent, handlebox.ydescent 
width, height - handlebox.width, handlebox.height 
patch = mpatches.Rectangle([x0, yO], width, height, face 
color='red', 
edgecolor='black', hatchz'xx' 
, lw-3, 
transform=handlebox.get_trans 
form( ) ) 
handlebox.add_artist(patch) 
return patch 


plt.legend([AnyObject()], ['My first handler'], 
handler map-[AnyObject: AnyObjectHandler()}) 


EJ My first handler 





或 者 ， 如 果 我 们 想 要 接受 全 局 的 AnyObject LH > f 28 — iA EX 
à handler map 关键 字 ， 我 们 可 以 注册 新 的 处 理 贤 : 


from matplotlib.legend import Legend 
Legend.update default handler map(i(AnyObject: AnyObjectHandler() 


}) 


虽然 这 里 的 功能 十 分 清楚 ， 请 记 住 ， 有 很 多 已 实现 的 处 理 器 ， 你 想 实 现 的 目标 可 能 
易于 使 用 现 有 的 类 实现 。 例如 ， 要 生成 椭圆 的 图 例 键 ， 而 不 是 矩形 键 : 


from matplotlib.legend handler import HandlerPatch 
import matplotlib.pyplot as plt 
import matplotlib.patches as mpatches 


class HandlerEllipse(HandlerPatch): 
def create artists(self, legend, orig handle, 
xdescent, ydescent, width, height, fontsi 
ze, trans): 
center = 0.5 * width - 0.5 * xdescent, 0.5 * height - 0.5 
* ydescent 
p = mpatches.Ellipse(xy=center, width=width + xdescent, 
height=height + ydescent) 
self.update prop(p, orig handle, legend) 
p.set transform(trans) 
return [p] 


c = mpatches.Circle((0.5, 0.5), 0.25, facecolor="green", 
edgecolor="red", linewidth-3) 
plt.gca().add patch(c) 


plt.legend([c], ["An ellipse, not a rectangle"], 
handler map-impatches.Circle: HandlerEllipse()}) 


[S B 


例 指南 


@® An ellipse, not a rectangle 





使 用 图 例 的 现 有 示例 


这 里 是 一 个 不 太 详 尽 的 示例 列表 ， 涉 及 以 各 种 方式 使 用 的 图 例 : 


lines bars and markers 示例 代码 : scatter with legend.py 
API 示例 代码 : legend demo.py 

pylab examples 示例 代码 : contourf hatching.py 

pylab examples 示例 代码 : figlegend demo.py 

pylab examples 示例 代码 : finance work2.py 

pylab examples 示例 代码 : scatter symbol.py 


ure Bees) mn. i ie 


matplotlib.pyplot.legend(*args, **kwargs) 文档 


在 轴 域 上 放置 一 个 图 例 。 


为 了 为 轴 域 上 已 经 存在 的 线条 (例如 通过 绘图 ) WHA REGAL RH TR 
代 对 象 (每 个 图 例 条 目 对 应 一 个 字符 串 ) 调用 此 函数 。 例 如 : 


ax.plot([i, 2, 3]) 
ax.legend(['A simple line']) 
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是 ， 为 了 使 标签 4」 和 图 例 元 素 实 例 保 持 一 致 ， 了 最 好 在 艺术 家 创建 时 指定 标签 ， 
或 者 通过 调用 艺术 家 的 set label() 方法 : 


De, - ax. aeger 2, 3], label='Inline label") 


4] ] i 8 | J} ] 4 De / Z 标 人 


nO scit 1abell( a via method') 
ax.legend() 


通过 定义 以 下 划 线 开头 的 标签 ， 可 以 从 图 例 元 素 自动 选择 中 排除 特定 线条 。 这 对 于 
所 有 艺术 家 都 是 默认 的 ， 因 此 不 带 任何 参数 调用 legend() ， 并 且 没 有 手动 设置 标 
ES = 致 没有 绘 会 制 | 图 例 o 

j^ 


t4 TE Fil MP , 术 家 拥有 图 例 条 目 ， 可 以 传递 拥有 图 例 的 艺术 家 的 可 和 迭代 对 
然后 是 相应 图 例 标签 的 可 和 失 ARE 


= Ay 


legend((linei, line2, line3), (‘label1', ‘label2', 'label3')) 


参数 
loc : 2H. FH BRAG AIA > RIA 'upper right' 。 
图 例 的 位 置 。 可 能 的 代码 是 : 


位 置 字符 囊 代码 


E 
jet 


‘best! 

"upper right! 
‘upper left' 
‘lower left' 
"lower right ' 
‘right ' 
‘center left' 
‘center right' 


‘lower center' 


oO O nN O Ci A WBN PP OO 


‘upper center' 


'center' 


Hm 
© 


或 者 ， 可 以 是 一 个 二 元 组 ， 提 供 图 例 的 距离 左下 角 的 x, y 坐标 (在 这 种 情况 
下 ， bbox to anchor RAW) 。 


bbox to anchor : matplotlib.transforms.BboxBase 示例 或 者 浮 点 元 组 。 


在 bbox transform 坐标 (默认 轴 域 坐标 ) 中 为 图 例 指定 任意 位 
例如 ， 要 将 图 例 的 右上 和 角 放 在 轴 域 中 心 ， 可 以 使 用 以 下 关键 字 : 


loc-'upper right', bbox to anchorz(0.5, 0.5) 


ncol :整数 。 
图 例 的 列 数 ， 默 认为 1。 
prop : None ` matplotlib.font_manager.FontProperties 或 者 字典 。 


图 例 的 字体 属性 ， 如 果 为 None (Ri) ， 会 使 用 当前 
的 matplotlib.rcParams ° 


fontsize : 整数 、 浮 点 或 
者 i'xx-small', 'x-small', ‘small’, ‘medium’, ‘large’, ‘x-large’, ‘x) 


Oo 


控制 图 例 的 字体 大 小 。 如 果 值 为 数字 ， 则 大 小 将 为 绝对 字体 大 小 《以 磅 为 单位 ) 。 
字符 串 值 相对 于 当前 默认 字体 大 小 。 此 参数 仅 在 未 指定 prop 的 情况 下 使 用 。 


numpoints : None 或 者 整数 。 


为 线条 / matplotlib.lines.Line2D 创建 图 例 条 目 时 ， 图 例 中 的 标记 点 数 。 默认 
值 为 None ， 它 将 从 legend.numpoints  rcParam 中 获取 值 。 


scatterpoints : None 或 者 整数 。 


为 散 点 图 / matplotlib.collections.PathCollection 创建 图 例 条 目 时 ， 图 例 中 
的 标记 点 数 。 默认 值 为 None ， 它 将 从 legend.scatterpoints  rcParam FR 
取 值 。 


scatteryoffsets : F84 NMR ° 


为 散 点 图 图 例 条 目 创 建 的 标记 的 重 下 偏 移 量 〈 相 对 于 字体 大 小 ) 。 0.0 是 在 图 例文 
本 的 底部 ，1.0 是 在 顶部 。 为 了 将 所 有 标记 绘制 在 相同 的 高 度 ， 请 设置 
为 [0.5] ° 默认 值 为 [0.375,0.5,0.3125] ° 


markerscale : None ` RRIF ° 


图 例 标 记 对 于 原始 绘制 的 标记 的 相对 大 小 。 默认 值 为 None ， 它 ] 
从 legend.markerscale  rcParam 中 获取 值 。 


x 


markerfirst : [ True | False ] 


如 果 为 True ， 则 图 例 标记 位 于 图 例 标签 的 左 侧 ， 如 有 果 为 False ， 图 例 标记 位 于 
图 例 标签 的 右 侧 。 


frameon : None 或 布尔 值 


控制 坪 否 应 在 图 例 周围 绘制 框架 。 默认 值 为 None ， 它 将 从 legend.frameon 
rcParam 中 获取 值 。 


fancybox : None 或 布尔 值 


控制 是 否 应 在 构成 图 例 背景 的 FancyBboxPatch AARAA > 默认 值 
为 None ， 它 将 从 legend.fancybox  rcParam 中 获取 值 。 


shadow : None 或 布尔 值 


控制 是 否 在 图 例 后 面 画 一 个 阴影 。 上 默认 值 为 None ， 它 将 从 legend.shadow 
rcParam 中 获取 值 。 


framealpha : None 或 浮 点 


控制 图 例 框 架 的 Alpha 透明 度 。 默认 值 为 None ， 它 将 从 legend.framealpha 
rcParam 中 获取 值 。 


mode : {"expand", None} 


如 果 mode HBA "expand" ， 图 例 将 水 平 扩展 来 填充 轴 域 区 域 (如 果 定 义 图 例 
的 大 小 ， 则 为 bbox to anchor ) ? 


bbox transform : None 或 者 matplotlib.transforms.Transform 


边界 框 的 变换 ( bbox to anchor ) ° 对 于 None W (默认 ) ， 将 使 
用 Axes 的 transAxes 变换 。 


title :字符 串 或 者 None 
图 例 的 标题 ， 默 认 没 有 标题 ( None ) 。 
borderpad : 浮 点 或 None 


图 例 边 框 的 内 边 距 。 以 字体 大 小 为 单位 度量 。 默认 值 为 None ， 它 将 
从 legend.borderpad  rcParam 中 获取 值 。 


labelspacing : 浮 点 或 None 


图 例 条 目 之 间 的 垂直 间距 。 以 字体 大 小 为 单位 度量 。 上 默认 值 为 None ， 它 将 
从 legend.labelspacing  rcParam 中 获取 值 。 


handlelength : 浮 点 或 None 


图 例 钉 柄 的 长 度 。 以 衬 体 大 小 为 单位 度量 。 默 认 值 为 None ， 它 将 
从 legend.handlelength  rcParam 取 值 。 


handletextpad : *#% None 


图 例 幻 柄 和 文本 之 间 的 间距 。 以 字体 大 小 为 单位 度量 。 默 认 值 为 None ， 它 将 
从 legend.handletextpad  rcParam 中 获取 值 。 


borderaxespad : 浮 点 或 None 


轴 和 图 例 边 框 之 间 的 间距 。 以 字体 大 小 为 单位 度量 。 RUA None ， 它 将 
从 legend.borderaxespad  rcParam 中 获取 值 。 


columnspacing : 浮 点 或 None 


列 间 距 。 以 字体 大 小 为 单位 度量 。 黑 认 值 为 None ， 它 将 
从 legend.columnspacing  rcParam 中 获取 值 。 


handler map : 字典 或 None 


Ae. FH o E TE EHR AA RA S| AAA 9 这 个 handler map 会 更 新 


在 matplotlib.legend.Legend.get legend handler map() 中 获得 的 默认 处 理 


变换 教程 


原文 : Transformations Tutorial 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


像 任何 图 形 包 一 样 ，matplotlib 建立 在 变换 框架 之 上 ， 以 便 在 坐标 系 ， 用 户 数 据 坐 
标 系 ， 轴 域 坐 标 系 ， 图 形 坐 标 系 和 显示 坐标 系 之 间 轻 易 变 换 。 在 95% 的 绘图 中 ， 
你 不 需要 考虑 这 一 点 ， 因 为 它 发 生 在 背后 ， 但 随 着 你 接近 自 定 义 图 形 生成 的 极限 ， 
它 有 助 于 理解 这 些 对 象 ， 以 便 可 以 重用 matplotlib 提供 给 你 的 现 有 变换 ， 或 者 创建 
自己 的 变换 ( 见 matplotlib.transforms ) 。 下 表 总 结 了 现 有 的 坐标 系 ， 你 应 
该 在 该 坐标 系 中 使 用 的 变换 对 象 ， 以 及 该 系统 的 描述 。 在 『 变 换 对 象 」 上 一列 

T^ ax x Axes 实例 ，fig 是 一 个 图 形 实 例 。 


标 db dup S 描述 


ax.transData 用 户 数 据 坐 标 系 ， 由 xlim fe ylim 控制 


轴 — 轴 域 坐标 系 ; (0,0) ARATA?’ (1,1) 是 轴 
域 | Ef 

本 图 形 坐 标 系 ; (0,0) KAŽETA? (1,1) 是 图 
形 Ef 


这 是 显示 器 的 像素 坐标 系 ; (0,0) 是 显示 器 的 左下 
g > (width, height) 是 显示 器 的 右上 角 ， 以 像 ; 
示 None 单位 。 或 者 ， 可 以 使 用 恒 等 变 换 
( matplotlib.transforms.IdentityTransformi 
来 代替 None 。 


上 表 中 的 所 有 变换 对 象 都 接受 以 其 坐标 系 为 单位 的 输入 ， 并 将 输入 变换 到 显示 坐标 
Áo 这 就 是 为 什么 显示 坐标 系 没 有 变换 对 象 」 的 原因 - 它 已 经 以 显示 坐标 为 单位 
Jo 变换 也 知道 如 何 反 转 自身， 从 显示 返回 目 身 的 坐标 系 。 这 在 处 理 来 自用 户 界 
面 的 事件 〈 通 第 发 生 在 显示 空间 中 ) ， 并 且 你 想 知 道 数据 坐标 系 中 鼠标 点 击 或 按键 
按 下 的 位 置 时 特别 有 用 。 


数据 坐标 


让 我 们 从 最 常用 的 坐标 ， 数 据 坐 标 系 开始 。 每 当 向 轴 域 添加 数据 时 ，matplotlib 会 
E MŽ > set xlim() 和 set ylim() 方法 最 第 用 于 更 新 。 例 如 ， 在 下 图 
中 ， 数 据 的 范围 在 x 轴 上 为 从 0 到 10， 在 y 轴 上 为 从 -1 到 1。 


import numpy as np 
import matplotlib.pyplot as plt 


x = np.arange(0O, 10, 0.005) 
- np.exp(-x/2.) * np.sin(2*np.pi*x) 


fig - plt.figure() 

ax = fig.add_subplot(ii1) 
ax.plot(x, y) 
ax.set_xlim(0, 10) 
ax.set_ylim(-i, 1) 


plt.show( ) 





你 可 以 使 用 ax.transData 实例 将 数据 变换 为 显示 坐标 系 ， 无 论 是 单个 点 或 是 一 
系列 点 ， 如 下 所 示 : 


In [14]: 


type(ax.transData) 


Out[14]: «class 'matplotlib.transforms.CompositeGenericTransform 
o 
In [15]: ax.transData.transform((5, 0)) 
Out[15]: array([ 335.175, 247. 1) 
In [16]: ax.transData.transform([(5, 0), (1,2)]) 
Out[16]: 
array([[ 335.175, 247. Il 
[ 132.435, 642.2 ]]) 
你 可 以 使 用 inverted() 方法 创建 一 个 变换 ， 从 显示 坐标 变换 为 数据 坐标 : 
In [41]: inv = ax.transData.inverted() 
In [42]: type(inv) 
Out[42]: «class 'matplotlib.transforms.CompositeGenericTransform 
= 
In [43]: inv.transform((335.175, 247.)) 
Out[43]: array([ 5., 0.]) 


如 果 你 一 直 关 注 本 教程 ， 如 果 你 的 窗口 大 小 或 dpi 设置 不 同 ， 显 示 坐 标的 确切 值 可 
能 会 有 所 不 同 。 同样， 在 下 面 的 图 形 中 ， 在 ipython 会 话 中 ， 由 显示 标记 的 点 可 能 
并 不 相同 ， 因 为 文档 图 形 大 小 默认 值 是 不 同 的 。 


data = (5.0, 0.0) 





[display = (281.9, 222.8) 


如 果 在 GUI 后 端 中 运行 上 述 示例 中 的 源 代 码 ， 你 还 可 能 发 现 数 据 和 显示 标注 的 
两 个 箭头 不 会 指向 完全 相同 的 点 。 这 是 因为 显示 点 是 在 显示 图 形 之 前 计算 的 ， 
并 且 GUI 后 端 可 以 在 创建 图 形 时 稍微 调整 图 形 大 小 。 如 果 你 自己 调整 图 的 大 
小 ， 效 果 更 明显 。 这 是 你 很 少 想 要 处 理 显 示 空 间 的 一 个 很 好 的 原因 ， 但 是 你 可 
以 连接 到 'on draw! 事件 来 更 新 图 上 的 图 坐标 ; 请 参阅 事件 处 理 和 选择 。 


当 你 更 改 轴 的 x 或 y 的 范围 时 ， 将 更 新 数据 沁 围 ， 以 便 变 换 生成 新 的 显示 点 。 
注意 ， 当 我 们 只 是 改变 ylim ， 只 有 y 显示 坐标 改变 ， 当 我 们 改变 xlim UA 
F o 我们 在 谈论 Bbox 时 会 深入 。 


In [54]: 
Out[54]: 


In [55]: 
Out [55]: 


In [56]: 
Out[56]: 


In [57]: 
Out[5/]: 


In [58]: 
Out[58]: 


ax.transData.transform((5, 0)) 
array([ 335.175, 247. ]) 


ax.set ylim(-1,2) 
(ed; 2) 


ax.transData.transform((5, 0)) 
array([ 335.175 7 181213333332) 


ax.set xlim(10,20) 
(10, 20) 


ax.transData.transform((5, 0)) 
array([-171.675 JNEEOTL 33539329915 


轴 域 坐标 


在 数据 坐标 系 之 后 ， 轴 域 可 能 是 第 二 有 用 的 坐标 系 。 这里， 点 (0,0) 是 轴 域 或 子 
图 的 左下 角 ， (0.5,0.5) X Ts» (1.0,1.0) 是 右上 角 。 你 还 可 以 引用 范围 之 
外 的 点 ， 因 此 (-0.1,1.1) 位 于 轴 的 左上 方 。 此 坐标 系 在 将 文本 放置 在 轴 中 时 非 
第 有 用 ， 因 为 你 通常 需要 在 固定 的 位 置 (例如 ， 轴 域 窗 格 的 左上 角 ) 放置 文本 气 
泡 ， 并 且 在 平移 或 缩放 时 保持 该 位 置 固定 。 这 里 是 一 个 简单 的 例子 ， 创 建 四 个 面 
板 ， 并 将 他 们 标记 为 TAT ，'B' CC'o» ID) ， 你 经 常 在 期 刊 上 看 到 它们 。 


1.0 1.0 
0.8 0.8 
0.6 0.6 
0.4 0.4 
0.2 0.2 
0.0 0.0 
0.00 0.25 050 O75 1.00 000 0.25 O50 0.75 1.00 
1.0 1.0 
0.8 0.8 
0.6 0.6 
0.4 0.4 
0.2 0.2 
0.0 


0.00 0.25 0.50 0.75 1.00 0.00 0.25 050 0.75 1.00 


你 也 可 以 在 轴 坐 标 系 中 创建 线条 或 者 补丁 ， 但 起 以 我 的 经 验 > 这 上 比 使 

用 ax. ees 放置 文本 更 不 实用 。 尽管 如 此 ， 这 里 是 一 个 思 大 的 例子 ， 它 在 
数据 空间 中 绘制 了 一 些 随 机 点 ， XRBEE—AJGuS 的 贺 上 面 ， 这 个 圆 以 轴 域 的 
中 心 为 圆心 ， ee 分 之 一 。- 如 果 你 的 轴 域 不 保留 高 宽 比 

(I set aspect () ) ， 它 将 看 起 来 像 一 个 椭圆 。 使 用 平移 /缩放 工具 移动 ， 或 

手动 更 改 数 据 的 xlim 和 ylim ， 你 将 看 到 数据 移动 ， 但 圆 将 保持 固定 ， 因 为 它 

不 在 数据 坐标 中 ， 并 且 将 始终 保持 在 轴 域 的 中 心 。 


de 


« 
^g 


AR ALA 


ani 





在 数据 与 轴 域 坐标 混合 的 混合 坐标 空间 中 绘制 是 非常 实用 的 ， 例 如 创建 一 个 水 平 路 
度 ， 突 出 y 数据 的 一 些 区 域 但 横 跨 x 轴 ， 而 无 论 数据 限制 ， 平 移 或 缩放 级 别 等 。 
实际 上 这 些 混 合 线条 和 跨度 非 第 有 用 ， 我 们 已 经 内 置 了 一 些 函 数 来 使 它们 容易 绘制 
(AIL axhline() ，axvline() > axhspan() > axvspan() ) ， 但 是 为 了 
教学 目的 ， 我 们 使 用 混合 变换 实现 这 里 的 水 平 跨 度 。 这 个 技巧 只 适用 于 可 分 离 的 变 
换 ， 就 像 你 在 正常 的 笛 卡 尔 坐 标 系 中 看 到 的 ， 但 不 能 为 不 可 分 离 的 变换 ， 

如 PolarTransform ( 极 坐 标 变换 ) © 
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import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.patches as patches 
import matplotlib.transforms as transforms 


fig - plt.figure() 
ax = fig.add_subplot(ii1) 


x = np.random.randn(1000) 


ax.hist(x, 30) 
ax.set_title(r'$\sigma=1 \/ \dots \/ Nsigma-2$', fontsize=16) 


# the x coords of this transformation are data, and the 

# y coord are axes 

trans = transforms.blended transform factory( 
ax.transData, ax.transAxes) 


# highlight the 1..2 stddev region with a span. 

# We want x to be in data coordinates and y to 

# span from 0..1 in axes coords 

rect = patches.Rectangle((i,0), width=1, height-!, 
transform=trans, color='yellow', 
alphaz0.5) 


ax.add patch(rect) 


plt.show() 
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混合 变换 非常 有 用 ， 其 中 x 为 数据 坐标 而 y 为 轴 域 坐标 ， 我 们 拥有 辅助 方法 
来 返回 内 部 使 用 的 版 本 mpl ， 用 于 绘制 ticks ， ticklabels 以 及 其 他 。 方 
法 

7 matplotlib.axes.Axes.get xaxis transform() 和 matplotlib.axes.A» 
。 因此， 在 上 面 的 示例 中 ， blended transform factory() “AAAs 
换 为 get xaxis transform 


trans = ax.get xaxis transform() 


使 用 偏 移 变 换 来 创建 阴影 效果 


变换 的 一 个 用 法 ， 是 创建 偏离 另 一 变换 的 新 变换 ， 人 例如， 放置 一 个 对 象 ， 相 对 于 另 
一 对 象 有 一 些 偏 移 。 通常 ， 你 希望 物理 尺寸 上 有 一 些 移 位 ， 例 如 以 点 或 英寸 ， 而 不 
是 数据 坐标 为 单位 ， 以 便 移 位 效果 在 不 同 的 缩放 级 别 和 dpi 设置 下 保持 不 变 。 


偏 移 的 一 个 用 途 是 创建 一 个 阴影 效果 ， 其 中 你 绘制 一 个 与 第 一 个 相同 的 对 有 象 ， 刚 好 
在 它 的 右边 和 下 面 ， 人 调整 zorder 来 确保 首先 绘制 阴影 ， 然 后 绘制 对 累 ， 阴 影 在 它 
之 上 。 变换 模块 具有 辅助 变换 ScaledTranslation 9» 它 可 以 这 样 来 实例 化 : 


trans = ScaledTranslation(xt, yt, scale trans) 
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其 中 xt 和 yt 是 变换 的 偏 移 ， scale trans 是 变换 ， 在 应 用 偏 移 之 前 的 变换 期 
间 缩 放 xt 和 yt 。 一 个 典型 的 用 例 是 ， 将 图 形 的 fig.dpi scale trans 变换 
用 于 scale trans 参数 ， 来 在 实现 最 终 的 偏 移 之 前 ， 首 先 将 以 点 为 单位 

的 xt fe yt 缩放 到 显示 空间 。 DPI 和 和 买 寸 偏 移 是 常见 的 用 例 ， 我 们 拥有 一 个 特 
殊 的 辅助 函数 ， 来 在 matplotlib.transforms.offset copy() 中 创建 它 ， 它 返 
回 一 个 带 有 附加 偏 移 的 新 变换 。 但 在 下 面 的 示例 中 ， 我 们 将 自己 创建 偏 移 变 换 。 
注意 使 用 加 法 运算 符 : 


offset = transforms.ScaledTranslation(dx, dy, 
fig.dpi scale trans) 
shadow transform = ax.transData + offset 


这 里 显示 了 ， 可 以 使 用 加 法 运算 符 将 变换 链 起 来 。 该 代码 表示 : 首先 应 用 数据 变 
换 ax.transData ， 然 后 由 dx 和 dy 点 翻译 数据 。 在 排版 中 ， 一 个 点 是 1/72 
英寸 ， 通 过 以 点 为 单位 指定 偏 移 ， 你 的 图 形 看 起 来 是 一 样 的 ， 无 论 所 保存 的 dpi 分 
Ee 


import numpy as np 

import matplotlib.pyplot as plt 

import matplotlib.patches as patches 
import matplotlib.transforms as transforms 


fig - plt.figure() 
ax = fig.add subplot(111) 


x = np.arange(0., 2., 0.01) 
y - np.sin(2*np.pi*x) 
line, = ax.plot(x, y, lw=3, color='blue' ) 


dx, dy = 2/72., -2/72. 

offset = transforms.ScaledTranslation(dx, dy, 
fig.dpi_scale_trans) 

Shadow_transform = ax.transData + offset 


ax.plot(x, y, lw=3, color='gray', 
transform-shadow transform, 
zorder=0.5*line.get_zorder() ) 


ax.set title('creating a shadow effect with an offset transform' 


) 
plt.show() 


creating a shadow effect with an offset transform 





0.00 0.25 050 0.75 2100 125 150 1.75 2.00 


我 们 在 本 教程 中 一 直 使 用 的 ax.transData 变换 是 三 种 不 同 变换 的 组 合 ， 它 们 构 
成 从 数据 到 显示 坐标 的 变换 流水 线 。 Michael Droettboom 实现 了 变换 框架 ， 提 供 
了 一 个 干净 的 API， 它 隔离 了 在 极 坐 标 和 对 数 坐 标 图 中 发 生 的 非 线性 投影 和 尺度 ， 
以 及 在 平移 和 缩放 时 发 生 的 线性 仿 射 变换 。 这 里 有 一 个 效 靳 问题， 因为 你 可 以 平移 
和 放大 你 的 轴 域 ， 它 会 影响 仿 射 变换 ， 但 你 可 能 不 需要 计算 潜在 的 兄 贵 的 非 线 性 比 
例 或 简单 的 导航 事件 的 投影 。 也 可 以 将 仿 射 变换 矩阵 相 乘 在 一 起 ， 然 后 在 一 步 之 中 
将 它们 应 用 于 坐标 。 这 对 所 有 可 能 的 变换 不 都 是 有 效 的 。 


这 里 是 在 ax.transData 实例 在 基本 可 分 离 的 Axes 类 中 的 定义 方式 。 


self.transData = self.transScale + (self.transLimits + self.tran 
SAxes) 


我 们 已 经 在 Axes 坐标 中 引入 了 上 面 的 transaxes 实例 ， 它 将 轴 或 子 图 边界 框 
的 (0,0) > (1,1) 角 映 射 到 显示 空间 ， 所 以 让 我 们 看 看 这 两 个 部 分 。 


self.transLimits 是 从 数据 到 轴 域 坐标 的 变换 ; 也 就 是 说 ， 它 将 你 的 视 
图 xlim 和 ylim 映射 到 轴 域 单位 空间 (然后 transAxes 将 该 单位 空间 用 于 显示 
空间 ) e 我 们 可 以 在 这 里 看 到 这 一 点 : 


In [80]: ax = subplot(111) 


In [81]: ax.set xlim(0, 10) 
Out[81]: (0, 10) 


In [82]: ax.set ylim(-1,1) 
Out[82]: (-1, 1) 


In [84]: ax.transLimits.transform((0, -1)) 
Out[84]: array([ 0., 0.]) 


In [85]: ax.transLimits.transform((10, -1)) 
Out[85]: array([ 1., 0.]) 


In [86]: ax.transLimits.transform((10,1)) 
Out[86]: array([ 1., 1.]) 


In [87]: ax.transLimits.transform((5,0)) 
Out[87]: array([ 0.5, 0.5]) 


而 且 我 们 可 以 使 用 相同 的 反 转 变换 ， 从 轴 域 单位 坐标 变换 回 数据 坐标 。 


In [90]: inv.transform((0.25, 0.25)) 
Out[90]: array([ 2.5, -0.5]) 


也 后 一 个 是 self.transScale 属性 ， 它 负责 数据 的 可 选 非 线 性 缩放 ， 例 如 对 数 轴 
域 。 当 Axes 初始 化 时 ， 这 只 是 设置 为 恒 等 变 换 ， 因 为 基本 的 matplotlib 轴 域 具有 
线性 缩放 ， 但 是 当 你 调用 对 数 缩放 有 函数 如 semilogx() 或 使 用 set xscale 显 式 
设置 为 对 数 时 ， ax.transScale 属性 为 处 理 非 线性 投影 而 设置 。 缩放 变换 是 相 
应 xaxis 和 yaxis 的 Axis 实例 的 属性 。 例如 ， 当 调 

用 ax.set xscale('log') N° xaxis 会 将 其 缩放 更 新 

为 matplotlib.scale.LogScale 实例 。 


对 于 不 可 分 离 的 轴 域 ， PolarAxes ， 还 有 一 个 要 考虑 的 部 分 ， 投 影 变 换 。 
matplotlib.projections.polar.PolarAxes 的 transData 类 似 于 典型 的 可 分 
& matplotlib 轴 域 ， 带 有 一 个 额外 的 部 分 ， transProjection 


self.transData = self.transScale + self.transProjection + \ 
(self.transProjectionAffine + self.transAxes) 


transProjection 将 来 自 空 间 的 投影 ， 例 如 ， 地 图 数据 的 纬度 和 经 度 ， 或 极 坐 标 
数据 的 半径 和 极 角 ， 处 理 为 可 分 离 的 箭 卡 尔 坐标 系 。 
在 matplotlib.projections 包 中 有 几 个 投影 示例 ， 深 入 了 解 的 最 好 方法 是 打开 
这 些 包 的 源 代码 ， 看 看 如 何 自己 制作 它 ， 因 为 matplotlib 支持 可 扩展 的 轴 域 和 投 
影 。 Michael Droettboom 提供 了 一 个 创建 一 个 锤 投影 轴 域 的 很 好 的 教程 示例 ; 请 
参阅 api 示例 代码 : custom projection example.py ° 
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路 径 教 程 


原文 : Path Tutorial 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


位 于 所 有 matplotlib.patch 对 象 底层 的 对 象 是 Path > CX 

持 moveto ， lineto ， curveto 命令 的 标准 几 个 ， 来 绘制 由 线段 和 样 条 组 成 的 
简单 和 复合 轮廓 。 路 径 由 (x,y) 顶点 的 (N,2) 数组 ， 以 及 路 径 代 码 的 长 度 为 N 
的 数组 实例 人 化。 例如， 为 了 绘制 (0,0) 到 (1,1) HRM > RAIT VASE A 
个 代码 


import matplotlib.pyplot as plt 
from matplotlib.path import Path 
import matplotlib.patches as patches 


verts = [ 
(9., 0.), Lefi bottom 
(0., 1.), Left, top 
(1., 1.), right, top 
(1. , O. ), [ 1C ht / bottom 
(0., 0.), # ignored 
] 


codes = [Path.MOVETO, 
Path.LINETO, 
Path.LINETO, 
Path.LINETO, 
Path.CLOSEPOLY, 


] 


path - Path(verts, codes) 


fig - plt.figure() 

ax = fig.add subplot(111) 

patch = patches.PathPatch(path, facecolor='orange', lw=2) 
ax.add patch(patch) 

ax.set xlim(-2,2) 

ax.set ylim(-2,2) 

plt.show() 





—£.0 -1.5 -10 -0.5 0.0 0.5 1.0 1.5 2.0 


下 面 的 路 径 代 码 会 被 接受 : 


代码 顶点 描述 
示 志 整个 路 径 终点 的 标记 (当前 不 需 
或 已 忽略 ) 
MOVETO 1 提起 笔 并 移动 到 指定 顶点 
LINETO 1 从 当前 位 置 向 指定 顶点 画 线 
2 (一 个 控制 点 ， 从 当前 位 置 ， 以 给 定 控制 点 向 给 定 端点 
CURVE3 pam a cd 
MI 2% P i UL 2E ZR 9 2X, 
3 (两 个 控制 点 从 当前 位 置 ， 以 给 定 控 制 点 向 给 定 端 点 
CURVE4 tk ea 
- 2% S) i — 2x DE 3E ZR ey 2X, 
占 ur ZZ. - 、 M 
CLOSEPOLY | f UA Am 向 当前 折线 的 起 点 画 线 
LER RB 
一 些 路 径 组 件 需 要 以 多 个 顶点 来 指定 : 例如 CURVES 是 具有 一 个 控制 点 和 一 个 端点 


的 贝 塞 尔 曲线 ， CURVE4 JUS Fi A 制 点 和 端点 的 三 个 顶点 。 下 面 的 示例 显 
示 了 CURVE4 LÆRER- 贝 旱 尔 曲线 将 包含 在 起 始点 ， 两 个 控制 点 和 终点 的 凸 包 
中 : 


import matplotlib.pyplot as plt 
from matplotlib.path import Path 
import matplotlib.patches as patches 


verts - [ 
(0., 0.), # PO 
(0.2, 1.), # P1 
(1., 0.8), # P2 
(0.8, 0.), # P3 
] 


codes = [Path.MOVETO, 
Path.CURVE4, 
Path.CURVE4, 
Path.CURVE4, 


] 


path = Path(verts, codes) 


fig = plt.figure() 

ax = fig.add_subplot(ii1) 

patch = patches.PathPatch(path, facecolor='none', lw=2) 
ax.add patch(patch) 


XS, yS - zip(*verts) 
ax.plot(xs, ys, 'x--', lw=2, color='black', ms=10) 


ax.text(-0.05, -0.05, 'PO') 
ax.text(0.15, 1.05, 'P1') 
ax.text(1.05, 0.85, 'P2') 
ax.text(0.85, -0.05, 'P3') 


ax.set_xlim(-0.1, 1.1) 
ax.set ylim(-0.1, 1.1) 
plt.show() 





复合 路 径 


所 有 在 matplotlib > Rectangle > Circle > Polygon 等 中 的 简单 补丁 原 语 都 是 用 简单 
的 路 径 实现 的 。 通 过 使 用 复合 路 径 ， 通 常 可 以 更 有 效 地 实现 绘制 函 净 
如 hist() 和 bar() ， 它 们 创建 了 许多 原 语 ， 例 如 一 堆 Rectangle ， 通 第 可 使 
用 复合 路 径 来 实现 。 bar 创建 一 个 矩形 列表 ， 而 不 是 一 个 复合 路 径 ， 很 大 程度 上 
an RURAL: 路 径 代 码 是 比较 新 的 ， bar 在 它 之 前 就 和 存在。 虽然 我 们 现在 可 以 
变 它 ， 但 它 会 破坏 日 的 代码 ， 所 以 如 果 你 需要 为 了 效率 ， 在 你 自己 的 代码 中 这 样 
做 ， 例如 ， 创 建 动画 条 形 图 ， 在 这 里 我 们 将 介绍 如 何 创 建 复合 路 径 ， 替换 bar 中 
的 功能 。 


我 们 将 通过 为 每 个 直方 图 的 条 形 创建 一 系列 矩形， 来 创建 直方 图 图 表 : 矩形 宽度 是 
AIG WY? FB RAK RD PRE a 数量 。 首 先 ， 我 们 将 创建 一 些 随 机 的 正 
态 分 布 数据 并 计算 直方 图 。 因 为 numpy 返回 条 形 边 缘 而 不 是 中 心 ， 所 以 下 面 的 示 
BP bins 的 长 度 比 n 的 长 度 大 1 


H his ogram ou data with nur 
TER = np. Fandom: al api 
n, bins - np.histogram(data, 100) 


RANT HE AG REI 89 f 9 下 面 的 每 个 left * bottom 等 数组 长 度 
为 len(n) ， 其 中 n 是 每 个 直方 图 条 形 的 计数 数组 : 


left = np.array(bins[:-1]) 
right = np.array(bins[:i:]) 
bottom = np.zeros(len(left)) 
top = bottom + n 


现在 我 们 必须 构造 复合 路 径 ， 它 由 每 个 矩形 的 一 系 

列 MOVETO ， LINETO 和 CLOSEPOLY 组 成 。 对 于 每 个 矩形 ， 我 们 需要 5 个 顶 
点 : 一 个 代表 MOVETO ， 三 个 代表 LINETO ， 一 个 代表 CLOSEPOLY ° 如 上 表 所 
示 ， closepoly 的 顶点 被 忽略 ， 但 我 们 仍然 需要 它 来 保持 代码 与 顶点 对 齐 : 


nverts = nrects*(1+3+1) 

verts = np.zeros((nverts, 2)) 

codes = np.ones(nverts, int) * path.Path.LINETO 
codes[0::5] = path.Path.MOVETO 

codes[4::5] = path.Path.CLOSEPOLY 


verts[0::5,0] = left 
verts[0::5,1] = bottom 
verts[1::5,0] = left 
verts[1::5,1] = top 
verts[2::5,0] = right 
verts[2::5,1] = top 
verts[3::5,0] = right 


verts[3::5,1] bottom 


剩 下 的 就 是 创建 路 径 了 ， 将 其 添加 到 PathPatch ， 将 其 添加 到 我 们 的 轴 域 : 


barpath = path.Path(verts, codes) 

patch = patches.PathPatch(barpath, facecolor='green', 
edgecolor-'yellow', alpha=0.5) 

ax.add patch(patch) 


结果 为 : 


路 径 教 程 
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BEE BAAS A 


原文 : Path effects guide 

译 者 : 飞龙 

Wu : CC BY-NC-SA 4.0 
Matplotlib 的 patheffects 模块 提供 了 一 些 功能 ， 用 于 将 多 个 绘制 层次 应 用 到 任 
何 艺术 家 ， 并 可 以 通过 路 径 呈 现 。 
可 以 对 其 应 用 路 径 效 果 的 艺术 家 包括 Patch ， Line2D ， Collection ， 巷 至 文 
本 。 每 个 艺术 家 的 路 径 效 果 都 可 以 通过 set_path_effects 方法 

( set path effects ) 控制 ， 它 需要 一 个 AbstractPathEffect 的 可 迭代 实 
AB] o 


最 简单 的 路 径 效 果 是 普通 效果 ， 它 简单 地 绘制 艺术 家 ， 并 没有 任何 效果 : 


import matplotlib.pyplot as plt 
import matplotlib.patheffects as path effects 


fig = plt.figure(figsize=(5, 1.5)) 
text = fig.text(0.5, 0.5, ‘Hello path effects world! \nThis is th 
e normal ' 
‘path effect.\nPretty dull, huh?', 
ha-'center', va='center', size-20) 
text.set path effects([path effects.Normal()]) 
plt.show() 


Hello path effects world! 
This is the normal path effect. 
Pretty dull, huh? 


添加 阴影 


比 正 第 效果 更 有 趣 的 路 径 效 果 是 阴影 ， 我 们 可 以 应 用 于 任何 基于 路 径 的 艺术 家 。 
SimplePatchShadow 和 SimpleLineShadow 类 通过 在 基本 艺术 家 下 面 绘制 填充 
补丁 或 线条 补丁 来 实现 它 : 


import matplotlib.pyplot as plt 
import matplotlib.patheffects as path effects 


text - plt.text(0.5, 0.5, 'Hello path effects world!', 
path effects-[path effects.withSimplePatchShadow 
()1) 


plt.plot([O, 3, 2, 5], linewidth=5, color='blue', 
path effects-[path effects.SimpleLineShadow(), 
path effects.Normal()]) 
plt.show() 


Hello. path, effects world! 





请 注意 本 示例 中 设置 路 径 效果 的 两 种 方法 。 第 一 个 使 用 with * 类 ， 来 包含 “ 正 
常 "效果 之 后 的 所 需 功 能 ， 而 后 者 明确 定义 要 绘制 的 两 个 路 径 效 果 。 


让 艺术 家 脱颖而出 


使 艺术 家 在 视觉 上 脱 缮 而 出 的 一 个 好 方法 是 ， 在 实际 艺术 家 下 面 以 粗 体 闫 色 绘 制 轮 
BB o Stroke 路 径 效 果 使 其 相对 简单 : 


import matplotlib.pyplot as plt 
import matplotlib.patheffects as path effects 


fig = plt.figure(figsize=(7, 1)) 
text = fig.text(0.5, 0.5, 'This text stands out because of\n' 
'its black border.', color='white', 
ha-'center', va='center', size-30) 
text.set path effects([path effects.Stroke(linewidth-3, foregrou 
nd-'black'), 
path effects.Normal()]) 
plt.show() 


This text stands out because 
its black border. 


重要 的 是 注意 ， 这 种 效果 能 够 工作 ， 因 为 我 们 已 经 绘制 两 次 文本 路 径 : KRM 
黑 线 ， 然 后 另 一 次 使 用 原始 文本 路 径 在 上 面 绘制 。 





您 可 能 已 经 注意 到 ， Stroke ^ SimplePatchShadow 和 SimpleLineShadow 的 
关键 字 不 是 通常 的 Artist 关键 字 (例如 facecolor 和 edgecolor +) 。 这 是 
因为 使 用 这 些 路 径 效 果 ， 我 们 操作 了 matplotlib 的 较 低层 。 实 际 上 ， 接 受 的 关键 字 
XH matplotlib.backend bases.GraphicsContextBase 实例 的 关键 宁 ， 它 
们 为 易于 创建 新 的 后 端 而 设计 ， 而 不 是 用 于 其 用 户 界面 。 


对 路 径 效 果 艺 术 家 的 更 大 控制 


如 前 所 述 ， 一 些 路 径 效 果 的 操作 级 别 低 于 大 多 数 用 户 操作 ， 这 意味 着 设置 关键 字 
(如 facecolor 和 edgecolor ) 会 导致 AttributeError 。 和 幸运 的 是 ， 有 一 个 
通用 的 PathPatchEffect 路 径 效果 ， 它 创建 一 个 具有 原始 路 径 

的 PathPatch 类 。 此 效果 的 关键 字 与 PathPatch 相同 : 


import matplotlib.pyplot as plt 
import matplotlib.patheffects as path effects 


fig = plt.figure(figsize=(8, 1)) 
t = fig.text(0.02, 0.5, 'Hatch shadow', fontsize-75, weight-1000 
, va='center' ) 
t.set_path_effects([path_effects.PathPatchEffect(offset=(4, -4), 
hatch='xxxx', 
facecolor-'gra 
y') 
path effects.PathPatchEffect(edgecolor-'whit 
e', linewidth=1.1, 


facecolor-'blac 


k')]) 
plt.show() 








文本 处 理 


原文 : Text introduction 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


matplotlib 具有 优秀 的 文本 支持 ， 包 括 数 学 表达 式 ， 光 栅 和 向 量 输出 的 truetype X 
持 ， 任 意 旋 转 的 换行 分 隔 文本 和 unicode 支持 。 AAR AHEM HCE PRAF 
体 ， 例 如 postscript 或 PDF， 你 在 屏幕 上 看 到 的 也 是 你 在 打印 件 中 得 到 的 。 
freetype2 可 产生 非常 漂亮 ， 抗 锯齿 的 字体 ， 即 使 在 小 光栅 尺寸 下 看 起 来 也 不 错 。 
matplotlib 拥有 自己 的 matplotlib.font manager °> Æi Paul Barrett， 他 实现 
了 一 个 跨 平 台 ， 符 合 W3C 标准 的 字体 查找 算法 。 

你 可 以 完全 控制 每 个 文本 属性 (字体 大 小 ， 字 体重 量 ， 文 本 位 置 和 颜色 等 ) ， 并 
在 rc 文件 中 设置 合理 的 默认 值 。 并 且 对 于 那些 对 数学 或 科学 图 像 感 兴趣 的 人 ， 
matplotlib 实现 了 大 量 的 TeX 数学 符号 和 命令 ， 来 支持 你 图 中 任何 地 方 放置 数学 表 


基本 的 文本 命令 
原文 : Basic text commands 
译 者 : 飞龙 
ti : CC BY-NC-SA 4.0 
text 


在 Axes 的 任意 位 置 添加 文本 。 


命令 式 : matplotlib.pyplot.text ， 面 向 对 
5$: matplotlib.axes.Axes.text ° 


xlabel 


向 x 轴 添 加 轴 标 签 。 


命令 式 : matplotlib.pyplot.xlabel ， 面 向 对 
5$ : matplotlib.axes.Axes.set xlabel 。 


ylabel 


6) y 轴 添 加 轴 标 签 。 


命令 式 : matplotlib.pyplot.ylabel ， 面 向 对 
% > matplotlib.axes.Axes.set ylabel 。 


title 


向 Axes 添加 标题 。 


命令 式 : matplotlib.pyplot.title ， 面 向 对 
Žž : matplotlib.axes.Axes.set title ° 


figtext 


向 Figure 的 任意 位 置 添 加 文本 。 


命令 式 : matplotlib.pyplot.figtext ， 面 向 对 
5$: matplotlib.figure.Figure.text ° 


suptitle 


向 Figure 添加 标题 。 


命令 式 : matplotlib.pyplot.suptitle ， 面 向 对 
象 : matplotlib.figure.Figure.suptitle 。 


annotate 


向 Axes 添加 标注 ， 带 有 可 选 的 箭头 。 


命令 式 : matplotlib.pyplot.annotate ， 面 向 对 
5$: matplotlib.axes.Axes.annotate ° 


所 有 这 些 函 数 创建 并 返回 一 个 matplotlib.text. J 实例 ， 它 可 以 配置 各 种 
字体 和 其 MER. 下 面 的 示例 在 实战 中 展示 所 有 这 些 命 令 。 


# -*- coding: utf-8 -*- 
import matplotlib.pyplot as plt 


fig = plt.figure() 

fig.suptitle('bold figure suptitle', fontsize=14, fontweight-'bo 
ld') 

ax = fig.add subplot(111) 

fig.subplots_adjust(top=0. 85) 

ax.set_title('axes title') 


ax.set xlabel('xlabel') 
ax.set ylabel('ylabel') 


ax.text(3, 8, ‘boxed italics text in data coords', style='italic' 
bbox={'facecolor':'red', 'alpha':0.5, 'pad':10)J) 

ax.text(2, 6, r'an equation: $bE-mc^2$', fontsize-15) 

ax.text(3, 2, u'unicode: Institut f\374r Festk\366rperphysik' ) 

ax.text(0.95, 0.01, 'colored text in axes coords', 
verticalalignment-'bottom', horizontalalignment='right', 


transform-ax.transAxes, 
color-'green', fontsize-15) 


ax.plot([2], [1], 0 ) 

ax.annotate('annotate', xy=(2, 1), xytext=(3, 4), 
arrowprops-dict(facecolor-'black', shrink=0.05)) 

ax.axis([0, 10, 0, 10]) 

plt.show() 


u———————————————— X nf 


基本 的 文本 命令 


bold figure suptitle 


axes title 


an equation: E= mc? 


ylabel 


annotate 


unicode: Institut fur Festkorperphysik 


colored text in axes coords 


xlabel 





115 


文本 属性 及 布局 


原文 : Text properties and layout 
译 者 : 飞龙 
It : CC BY-NC-SA 4.0 


matplotlib.text.Text 实例 有 各 种 属性 ， 可 以 通过 关键 字 参 数 配置 文本 命令 
(例如 ， title() ， xlabel() 和 text() ) ° 


属性 值 类 型 
alpha 浮 点 
backgroundcolor 任何 matplotlib Zi & 
bbox rectangle prop dict plus key 'pad' which is a pad in points 
clip box matplotlib.transform.Bbox 实例 
clip on [True / False] 
clip path Path * Transform X Patch 实例 
color 任何 matplotlib Z5 & 
family | 'serif' / 'sans-serif' / 'cursive' / 'fantasy 
fontproperties matplotlib.font manager.FontProperties 实例 
ee nen | “center” 7 "right 7 left’ | 
label 任何 字符 串 
linespacing 浮 点 
multialignment [ left' / right / center | 
name or fontname 字符 串 ， 例 如 ['Sans' / 'Courier' / 'Helvetica' 
picker [ None / 浮 点 /布尔 值 /可 人 调用 对 象 ] 
position (x,y) 
rotation [ 角度 制 的 角度 /vertical' / horizontal’ 
size or fontsize [ 点 的 尺寸 


style or fontstyle [ ‘normal’ / ‘italic’ / 'oblique'] 


text 字符 串 或 任何 可 使 用 '%s' 打印 的 东西 


transform matplotlib.transform 实例 

variant [| 'normal' / 'small-caps' | 

din dd E | "center 7 top’ / "bottom" 7 ‘baseline’ | 

V 

visible [True / False] 

weight or [ 'normal' / 'bold' / 'heavy' / 'light' / 'ultr 
fontweight 

X iF 

y 浮 点 

zorder 任意 数值 


你 可 以 使 用 对 齐 参 

Zt horizontalalignment * verticalalignment 和 multialignment 来 布置 
文本 。 horizontalalignment 控制 文本 的 x 位 置 参 数 衣 示 文 本 边界 框 的 左边 ， 
中 间或 右边 。 verticalalignment 控制 文本 的 y 位 置 参数 表示 文本 边界 框 的 辰 
部 ， 中 心 或 顶部 。 multialignment ， 仅 对 于 换行 符 分 隔 的 字符 串 ， 控 制 不 同 的 
行 是 左 ， 中 还 是 右 对 齐 。 这 里 是 一 个 使 用 text() 命令 显示 各 种 对 齐 方式 的 例 
子 。 在 整个 代码 中 使 用 transform = ax.transAxes ， 表 示 坐 标 相 对 于 轴 边 界 框 
给 出 ， 其 中 0,0 是 轴 的 左下 角 ， 1,1 是 右上 角 。 


import matplotlib.pyplot as plt 
import matplotlib.patches as patches 
t build a rectangle in axes coords 
left, width = .25, .5 

bottom, height - .25, .5 

right = left + width 

top = bottom + height 


fig - plt.figure() 
ax = fig.add axes([0,0,1,1]) 


4 axes coordinates are 0,0 is bottom left and 1,1 is upper right 
p = bes. estie 

(left, bottom), width, height, 

fill-False, transform=ax.transAxes, clip on-False 


) 
ax.add_patch(p) 


ax.text(left, bottom, ‘left top', 
horizontalalignment='left', 
verticalalignment='top', 


ax. 


ax. 


ax. 


ax. 


ax. 


ax. 


ax. 


ax. 


ax. 


ax. 


transform=ax.transAxes ) 


text(left, bottom, ‘left bottom', 
horizontalalignment='left', 
verticalalignment='bottom', 
transform=ax.transAxes ) 


text(right, top, ‘right bottom', 
horizontalalignment='right', 
verticalalignment='bottom', 
transform=ax.transAxes ) 


text(right, top, ‘right top', 
horizontalalignment='right', 
verticalalignment='top', 
transform=ax.transAxes ) 


text(right, bottom, ‘center top', 
horizontalalignment='center', 
verticalalignment='top', 
transform=ax.transAxes ) 


text(left, 0.5*(bottom-top), ‘right center', 
horizontalalignment='right', 
verticalalignment='center', 
rotation='vertical', 
transform=ax.transAxes ) 


text(left, 0.5*(bottom-top), ‘left center', 
horizontalalignment='left', 
verticalalignment='center', 
rotation='vertical', 
transform=ax.transAxes ) 


text(0.5*(Llefttright), 0.5*(bottom+top), 'middle', 


horizontalalignment='center', 
verticalalignment='center', 
fontsize-20, color='red', 
transform=ax.transAxes ) 


text(right, 0.5*(bottom-top), 'centered', 
horizontalalignment='center', 
verticalalignment='center', 
rotation='vertical', 
transform=ax.transAxes ) 


text(left, top, ‘rotated\nwith newlines', 
horizontalalignment='center', 
verticalalignment='center', 
rotation=45, 
transform=ax.transAxes ) 


set_axis_off() 


plt.show() 
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默认 字体 


原文 : Text properties and layout 


译 者 : 飞龙 
协 仅 : CC BY-NC-SA 4.0 
基本 的 默认 字体 由 一 系列 rcParams 参数 控制 : 
rcParam HE 
字体 名 称 
"font.family' EA ('cwregwe'. rianta Tinerosmace’, "seme". | 
列表 
'font.style' SUA CER > B42 'normal' ° ‘italic’ 
'font.variant' 默认 变 体 ， 例 如 'normal' > 'small-caps' (未 测试 ) 
'font.stretch' 默认 拉 伸 'normal' > 'condensed' (未 完成 ) 
'font.weight' 字体 粗细 ， 可 为 整数 或 字符 串 
Iront cize. 默认 字体 大 小 (以 磅 为 单位 ) 。 相对 字体 大 小 ( 'large' 
字体 系列 别名 
( {'cursive' > 'fantasy' > 'monospace' > 'sans' > 'sans serif', 'sans-ser 


) 和 实际 字体 名 称 之 间 的 映射 由 以 下 rcParams 控制 


系列 别名 映射 的 rcParam 
"serif' "font.serif' 
‘monospace ' "font.monospace' 
‘fantasy ' "font.fantasy' 
‘cursive! "font.cursive' 
{'sans', 'sans serif', 'sans-serif')! "font.sans-serif' 


它 是 字体 名 称 的 列表 。 


非 拉丁 字形 文本 


从 v2.0 开始 ， 默 认 字 体 包 人 钨 许多 西方 字母 的 字形 ， 但 仍然 没有 敌 盖 mpl 用 户 可 能 
需要 的 所 有 字形 。 例如 ，DejaVu AAR ZFX’ HIE RAE © 


要 将 默认 字体 设置 为 支持 所 需 代 码 点 的 字体 ， 请 将 字体 名 称 添 加 
到 font.family 或 所 需 的 别名 列表 前 面 。 


matplotlib.rcParams['font.sans-serif'] = ['Source Han Sans TW', 


'sans-serif'] 


或 在 .matplotlibrc 文件 中 设置 : 


font.sans-serif: Source Han Sans TW, Ariel, 


sans-serif 


要 控制 每 个 艺术 家 使 用 的 字体 ， 使 用 上 面 记 录 | 
'fontname' 或 'fontproperties' 关键 字 参 数 。 


fc-list 是 用 于 发 现 字 体 名 称 的 实用 工具 ; 例如 


的 


列 出 了 所 有 支持 中 文 的 字体 。 


'name' ° 


Æ linux 上 ， 


$ fc-list :lang-zh family 
to Sans Mono CJK 


Noto 
Noto 
Noto 
Noto 
Noto 
Noto 
Noto 


sans 
sans 
sans 
sans 
sans 
sans 


CJK TC, Noto 
CJK TC, Noto 
CJK KR, Noto 
CJK TC, Noto 
Mono CJK TC, 
CJK SC, Noto 


TC,Noto Sans Mono CJK TC Bold 


sans 
sans 
sans 
sans 
Noto 
sans 


CJK TC Medium 

CJK TC DemiLight 

CJK KR Black 

CJK TC Black 

Sans Mono CJK TC Regular 
CJK SC Light 


原文 : Annotation 
译 者 : 飞龙 
Wu : CC BY-NC-SA 4.0 


基本 标注 


使 用 text() 会 将 文本 放置 在 轴 域 的 任意 位 置 。 文 本 的 一 个 常见 用 例 是 标注 绘图 
的 茶 些 特征 ， 而 annotate() 方法 提供 辅助 函数 ， 使 标注 变 得 容易。 在 标注 中 ， 
有 两 个 要 考虑 的 点 。 由 参数 Xy 表示 的 标注 位 置 和 xytext 的 文本 位 置 9 这 两 个 
参数 都 是 (x, y) 元 组 。 


import numpy as np 
import matplotlib.pyplot as plt 


fig - plt.figure() 
ax = fig.add_subplot(ii1) 


np.arange(0.0, 5.0, 0.01) 
np.cos(2*np.pi*t) 
ine, - ax.plot(t, s, lw-2) 


ax.annotate('local max', xy=(2, 1), xytext=(3, 1.5), 
arrowprops-dict(facecolor-'black', shrink=0.05), 


ax.set ylim(-2,2) 
plt.show() 


源 代 码 


local max 





在 该 示例 中 ， xy (WAR) 和 xytext 位 置 (文本 位 置 ) 都 以 数据 坐标 为 单 
位 。 有 多 种 可 以 选择 的 其 他 坐标 系 - 你 可 以 使 用 xycoords 和 textcoords 以 及 
下 列 字 符 串 之 一 〈 软 认为 data ) 指定 xy 和 xytext 的 坐标 系 。 


参数 | 坐标 系 || 'figure points' | E à E76 Z TS 89 XC | | 

'figure pixels' | 距离 图 形 左 下 角 的 像 杀 数量 || 'figure fraction' |0,0 

是 图 形 左 下 角 ，1,1 是 右上 有 角 || 'axes points' | 距离 轴 域 左下 角 的 点 数量 | | 
'axes pixels' | 距离 轴 域 左下 有 角 的 像 杀 数量 || 'axes fraction' |0,0 Æ$ 

域 左 下 角 ，1,1 是 右上 角 || 'data' | 使 用 轴 域 数据 坐标 系 | 


例如 将 文本 以 轴 域 小 数 坐 标 系 来 放置 ， 我 们 可 以 : 








ax.annotate('local max', xy=(3, 1), Xycoords= data ， 
xytext=(0.8, 0.95), textcoords='axes fraction', 
arrowprops-dict(facecolor-'black', shrink=0.05), 
horizontalalignment-'right', verticalalignment='top' 


) 


对 于 物理 坐标 系 〈 点 或 像素 ) ， 原 点 征 图 形 或 轴 的 左下 角 。 


或 者 ， 你 可 以 通过 在 可 选 关 键 字 参数 arrowprops 中 提供 箭头 属性 字典 来 绘制 从 
文本 到 注释 点 的 箭头 。 


arrowprops 键 描述 


width 箭头 宽度 ， 以 点 为 单位 
frac 箭头 头 部 所 占据 的 比例 
headwidth 箭头 的 底部 的 宽度 ， 以 点 为 单位 
shrink 移动 提示 ， 并 使 其 离 注释 点 和 文本 一 些 距离 
j at a 9 AA 
RE matplotlib.patches.Polygon 的 任何 键 ， 例 


如 facecolor 


在 下 面 的 示例 中 ， xy 点 是 原始 坐标 ( xycoords 默认 为 'data' ) 。 对 于 极 坐 
标 轴 ， 它 在 (theta, radius) 空间 中 。 此 示例 中 的 文本 放置 在 图 形 小 数 坐标 系 
中 。 matplotlib.text.Text 关键 宁 args ° ff| 


如 horizontalalignment ， verticalalignment 和 fontsize ， 
从 annotate 传 给 Text 实例 。 


源 代 码 





a polar annotation 270° 


注释 (包括 花 式 箭 头 ) 的 所 有 高 上 大 的 内 容 的 更 多 信息 ， 请 参阅 高 级 标注 
和 pylab examples 示例 代码 : annotation demo.py ° 


不 要 继续 ， 除 非 你 已 经 阅读 了 基本 标注 ， text() 和 annotate() ° 


4s JF] HE To SC AR RARE 
让 我 们 以 一 个 简单 的 例子 来 开始 。 
源 代码 


e? (Sample B` 


Sample AR, ZT 





在 pyplot 模块 (或 Axes 类 的 text 方法 ) 中 的 text() 函数 接受 bbox 关键 
字 参 数 ， 并 且 在 提供 时 ， 在 文本 周围 绘制 一 个 框 。 


与 文本 相关 联 的 补丁 对 象 可 以 通过 以 下 方式 访问 : 


bb = t.get bbox patch() 


返回 值 是 FancyBboxPatch 的 一 个 实例 ， 并 且 补 丁 属性 
(如 facecolor ， edgewidth +) 可 以 像 平 常 一 样 访 问 和 修改 。 为 了 更 改 框 的 
形状 ， 请 使 用 set boxstyle 方法 。 


bb.set boxstyle("rarrow", pad=0.6) 


该 参数 是 框 样式 的 名 称 与 其 作为 关键 字 参 数 的 属性 。 目前， 实现 了 以 下 框 样 式 。 


Circle 
DArrow 
LArrow 
RArrow 
Round 
Round4 
Roundtooth 
Sawtooth 


Square 


源 代 码 


名 称 
circle 
darrow 
larrow 
rarrow 
round 
round4 
roundtooth 
sawtooth 


square 


pad=0. 
pad=0. 
pad=0. 
pad=0. 
pad=0. 
pad=0. 
pad=0. 
pad=0. 


pad=0. 


3 

3 

3, rounding_size=None 
3, rounding_size=None 
3, tooth_size=None 

3, tooth_size=None 


3 





circle 


< larrow | 









rarrow ` 


round 
round4 


roundtooth; 








square 


注意 ， 属 性 参数 可 以 在 样式 名 称 中 用 各 号 分 隔 (在 初始 化 文本 实例 时 ， 此 形式 可 以 
用 作 bbox 参数 的 boxstyle 的 值 ) 。 


bb.set_boxstyle("rarrow, pad=0.6" ) 


使 用 箭头 来 标注 


pyplot 模块 (或 Axes 类 的 annotate 方法 ) 中 的 annotate() 函数 用 于 绘制 
连接 图 上 两 点 的 前 头 。 


ax.annotate("Annotation", 
Xy-(x1, y1), xycoords='data', 
xytext=(x2, y2), textcoords-'offset points', 


) 


这 会 使 用 textcoords 中 提供 的 ， xytext 处 的 文本 标注 提供 坐标 
( xycoords ) 中 的 xy 处 的 点 。 通 第 ， 数 据 坐 标 中 规定 了 标注 点 ， 偏 移 点 中 规 
定 了 标注 文本 。 请 参阅 annotate() 了 解 可 用 的 坐标 系 。 


连接 两 个 点 ( xy 和 xytext ) 的 前 头 可 以 通过 指定 arrowprops 参数 可 选 地 绘 
制 。 为 了 仅 绘 制 箭头 ， 请 使 用 空 字符 串 作 为 第 一 个 参数 。 


ax.annotate("", 
xy=(0.2, 0.2), xycoords-'data', 
xytext=(0.8, 0.8), textcoords='data', 
arrowprops=dict(arrowstyle="->", 
connectionstyle="arc3"), 
) 


源 代 码 


1.0 
0.8 
0.6 
0.4 
0.2 


0.0 
0.0 0.2 0.4 0.6 0.8 1.0 


箭头 的 绘制 需要 几 个 步骤 。 


e 创建 两 个 点 之 间 的 连接 路 径 。 这 由 connectionstyle 键 值 控制 。 

e 如 果 提 供 了 补丁 对 象 ( patcha 和 patchB ) > MAW WHER GSA 
qus 

e 路 径 进 一 步 由 提供 的 像素 总 量 来 缩小 ( shirnkA & shrinkB ) 

e 路 径 转换 为 箭头 补丁 ， 由 arrowstyle 键 值 控制 。 


源 代 码 





两 个 点 之 间 的 连接 路 径 的 创建 由 connectionstyle 键 控制 ， 并 且 可 用 以 下 样式 。 


名 称 属性 
angle angleA=90, angleB=0, rad=0.0 
angle3 angleA=90, angleB=0 
arc angleA=0, angleB=0, armA=None, armB=None, rad=0.0 
arc3 rad=0.0 
bar armA=0.0, armB=0.0, fraction=0.3, angle=None 


注意 ， angle3 和 arc3 中 的 3 意味 着 所 得 到 的 路 径 是 二 次 样 条 段 (三 个 控制 
点 ) 。 如 下 面 将 讨论 的 ， 当 连 接 路 径 是 二 次 样 条 .时 ， 可 以 使 用 一 些 箭头 样式 选 先 项 。 


每 个 连 车 接 样式 的 行为 在 下 面 的 示例 中 (有 限 地 ) X (A: 条 形 样 式 的 行为 当 
前 未 定义 好 ， 将 来 可 能 会 更 改 ) 。 


源 代码 


| angle3, | angle, | arc, | bar, 
angleA=90, angleA--90, angleA--90, fraction 0.3 


angleB=0 angleB=180, 
rad=0 


| angle, 
angleA--90], 


angleB=90 angleB-180, 
rad=5 


Ro 
j "d 


bar, 

angle-180, 
angleB=10, y fraction=-0.2 
rad=0 





然后 根据 给 定 的 箭头 样式 将 连接 路 径 〈 在 剪 切 和 收缩 之 后 ) 变换 为 箭头 补丁 。 


名 称 属性 

None 

> head_length=0.4, head_width=0. 2 

-[ widthB-z1.0,lengthB-z0.2,angleB-None 


|-| widthA=1.0,widthB=1.0 


-|> head_length=0.4, head_width=0. 2 

<- head_length=0.4, head_width=0. 2 

<-> head_length=0.4, head_width=0. 2 

<|- head_length=0.4, head_width=0. 2 

< -|> head_ler 
fancy head_length=0.4, head_width=0.4, tail_width=0.4 


simple head_length=0.5, head_width=0.5, tail_width=0.2 


wedge tail _width=0.3,shrink_factor=0.5 


源 代 码 


-| 一 @ <[-1>| -一 全 
[30 re 
i:j—]1e Te 
->|—®@ [fancy] — @ 
[-.]— e [simple | —> 6 
[2| [wedge] — 6 
=] — 6 He 


一 些 箭 头 仅 适用 于 生成 二 次 样 条 线段 的 连接 样式 。 他 们 
是 fancy ， simple > wedge 。 对 于 这 些 和 荫 头 样式 ， 必 须 使 
用 angle3 或 arc3 连接 样式 。 


如 果 提 供 了 标注 字符 串 ， 则 patcha 默认 设置 为 文本 的 bbox 补丁 。 
源 代码 










0.0 0.2 0.4 0.6 0.8 1.0 


Lj text 命令 一 样 ， 可 以 使 用 bbox 参数 来 绘制 文本 周围 的 框 。 


源 代 码 








默认 情况 下 ， edet leni 2 围 的 中 心 。 可 以 使 用 relpos 键 值 进行 调整 。 这 
些 值 根据 文本 的 范 行 归 一 化 。 例如， (0,0) 表示 左下 角 ， (1,1) Eis 右上 
A O 

源 代码 

将 艺术 冢 放置 在 轴 域 的 锚 定 位 置 

有 一 类 艺术 家 可 以 放置 在 轴 域 的 锚 定 位 置 。 一 个 第 见 的 例子 是 图 例 。 这 种 类 型 的 


艺术 家 可 以 使 用 offsetBox 类 创建 。 
mpl toolkits.axes grid.anchored artists 中 有 几 个 预定 义 


from mpl toolkits.axes grid.anchored artists import AnchoredText 
at - AnchoredText("Figure 1a", 

prop=dict(size=8), frameon=True, 

illos 


at.patch.set boxstyle("round,pad-z0.,rounding size-0.2") 
ax.add artist(at) 


源 代 码 





00 02 04 06 08 1.0 
loc 关键 字 与 legend 命令 中 含义 相同 。 


一 个 简单 的 应 用 是 当 艺 术 家 (或 艺术 家 的 集合 ) 的 像素 大 小 在 创建 时 已 知 。 例如 ， 
如 果 要 绘制 一 个 固定 大 小 为 20 像素 x20 像素 (半径 为 10 像素 ) 的 圆 ， 则 可 以 使 
用 AnchoredDrawingArea ° 实例 使 用 绘图 区 域 的 大 小 创建 (XS A) o 


用 户 可 以 在 绘图 区 任意 添加 艺术 家 。 注 意 ， 添 加 到 绘图 区 域 的 艺术 家 的 范围 与 绘制 


区 域 本 身 的 位 置 无 关 ， 只 和 初始 大 小 有 关 。 


from mpl toolkits.axes grid.anchored artists import AnchoredDraw 
ingArea 


ada = AnchoredDrawingArea(20, 20, 0, 0, 

loc=1, pad=0., frameon-False) 
pi = Circle((10, 10), 10) 
ada.drawing_area.add_artist(p1) 
p2 = Circle((30, 10), 5, fc="r") 
ada.drawing_area.add_artist(p2) 


添加 到 绘图 区 域 的 艺术 家 不 应 该 具有 变换 集 〈 它 们 将 被 重 写 ) ， 并 且 那 些 艺 术 家 的 
尺寸 被 解释 为 像 订 坐标 ， 即 ， 上 述 示例 中 的 圆 的 半径 分 别 是 10 像 系 和 5 像素 。 


源 代 码 





有 了 时， 你 想 让 你 的 艺术 家 按 数据 坐标 (或 其 他 坐标 ， 而 不 是 画布 像素 ) 缩放 。 你 可 
以 使 用 AnchoredAuxTransformBox 类 。 这 类 似 于 AnchoredDrawingArea °’ KR 
了 艺术 家 的 沁 围 在 绘制 时 由 指定 的 变换 确定 。 

from mpl toolkits.axes grid.anchored artists import AnchoredAuxT 

ransformBox 

box - AnchoredAuxTransformBox(ax.transData, loc-2) 

el = Ellipse((0,0), width=0.1, height=0.4, angle-30) # in data c 


oordinates! 
box.drawing area.add artist(el) 


上 述 示例 中 的 椭圆 具有 在 数据 坐标 中 对 应 于 0.1 fe 0.4 的 宽度 和 高 度 ， 并 且 当 轴 域 
的 视图 限制 改变 时 将 目 动 缩放 。 


源 代 码 


1.0 


0.8 





0.6 


0.4 


如 图 例 所 示 ， 可 以 设置 bbox to anchor 参数 。 使 用 HPacker 和 VPacker ， 
你 可 以 像 图 例 中 一 样 排列 艺术 家 (事实 上 ， 这 是 图 例 的 创建 方式 ) e 


产 代码 
1.0 

0.8 

0.6 


0.4 


请 注意 ， 与 图 例 不 同 ， 默 认 情 况 下 ， bbox transform 设置 
为 IdentityTransform 。 


使 用 复杂 坐标 来 标注 
matplotlib 中 的 标注 支持 标注 文本 中 描述 的 几 种 类 型 的 坐标 。 对 于 想 要 更 多 控制 的 
高 级 用 户 ， 它 支持 几 个 其 他 选项 。 


1. Transform 实例 ， 例 如 : 
ax.annotate("Test", xyz(0.5, 0.5), xycoords=ax.transAxes) 
相当 于 : 
ax.annotate("Test", xy=(0.5, 0.5), xycoords="axes fraction") 
使 用 它 ， 你 可 以 在 其 他 轴 域 内 标注 一 个 点 : 


ax1, ax2 = subplot(i21), subplot(122) 

ax2.annotate("Test", xyz(0.5, 0.5), xycoords-axi.transData, 
xytext=(0.5, 0.5), textcoords=ax2.transData, 
arrowprops=dict (arrowstyle="->" ) ) 


2. Artist 实例 。 xy 4& (3X xytext ) 被 解释 为 艺术 家 
的 bbox ( get window extent 的 返回 值 ) 的 小 数 坐 标 。 


ani = ax.annotate("Test 1", xy=(0.5, 0.5), xycoords="data", 
va="center", ha="center", 
bbox=dict(boxstyle="round", fc="w")) 

an2 = ax.annotate("Test 2", xy=(1, 0.5), xycoords=ani, # (1, 

9.5) of the ani's bbox 
xytext=(30,0), textcoords="offset points", 
va="center", ha="left", 
bbox=dict(boxstyle="round", fcz"w"), 
arrowprops=dict(arrowstyle="->" ) ) 


源 代 码 
1.0 
0.8 


0.6 


(resi) — (rescz 


0.4 


0.2 





0.0 
0.0 0.2 0.4 0.6 0.8 1.0 

请 注意 ， 你 的 责任 是 在 绘制 an2 之 前 确定 坐标 艺术 家 (atig ant ) 的 范 

。 在 大 多 数 情 况 下 ， 这 意味 着 an 需要 晚 于 ani 。 


3. 一 个 返回 BboxBase 或 Transform 的 实例 的 可 调用 对 旭 。 如 果 返 回 一 个 变 
换 ， 它 与 1 相同， 如果 返回 bbox ， 它 与 2 相同 。 可 调用 对 象 应 该 接 
Z renderer 实例 的 单个 参数 。 例 如 ， 以 下 两 个 命令 产生 相同 的 结果 : 


an2 = ax.annotate("Test 2", xy=(1, 0.5), xycoords=an1, 
xytext=(30,0), textcoords="offset points") 
an2 = ax.annotate("Test 2", xy=(1, 0.5), xycoords-ani.get wi 
ndow_extent, 
xytext=(30,0), textcoords="offset points") 


4. 指定 二 元 坐标 的 元 组 。 第 一 项 用 于 x 坐标 ， 第 二 项 用 于 y 坐标 。 例如， 


annotate("Test", xyz(0.5, 1), xycoords=("data", "axes fracti 
on" )) 


0.5 的 单位 是 数据 坐标 ，1 的 单位 是 归 一 化 轴 域 坐标 。 你 可 以 像 使 用 元 组 一 样 
使 用 艺术 家 或 变换 。 例 如， 


import matplotlib.pyplot as plt 


plt.figure(figsize=(3,2)) 

ax=plt.axes([0.1, 0.1, 0.8, 0.7]) 

ani = ax.annotate("Test 1", xy=(0.5, 0.5), xycoords="data", 
va="center", ha="center", 
bbox=dict(boxstyle="round", fc="w")) 


an2 = ax.annotate("Test 2", xy=(0.5, 1.), xycoords=an1, 
xytext=(0.5,1.1), textcoords=(ani, "axes f 


raction"), 
va="bottom", ha="center", 
bbox=dict(boxstyle="round", fc="w"), 
arrowprops=dict(arrowstyle="->" ) ) 
plt.show( ) 
源 代 码 





.0 
0.0 0.7 0.4 0.6 0.8 1.0 


. 有 时 ， 您 希望 您 的 注释 带 有 一 些 " 偏 移 点 "， 不 是 距离 注释 点 ， 而 是 距离 某 些 其 
他 点 。 OffsetFrom 是 这 种 情况 下 的 辅助 类 。 


import matplotlib.pyplot as plt 


plt.figure(figsize=(3,2)) 

ax=plt.axes([0.1, 0.1, 0.8, 0.7]) 

ani = ax.annotate("Test 1", xy=(0.5, 0.5), xycoords="data", 
va="center", ha="center", 
bbox=dict(boxstyle="round", fc="w")) 


from matplotlib.text import OffsetFrom 

offset from = OffsetFrom(ani, (0.5, 0)) 

an2 = ax.annotate("Test 2", xy=(0.1, 0.1), xycoords="data", 
xytext=(0, -10), textcoords=offset_from, 
# xytext is offset points from "xy=(0.5, 0 

), xycoords=ani" 
va="top", ha="center", 
bbox=dict(boxstyle="round", fc="w"), 
arrowprops=dict(arrowstyle="->" ) ) 


plt.show( ) 





.0 
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你 可 以 参考 这 个 链 
接 : pylab examples example code: annotation_demo3.py. ° 


使 用 ConnectorPatch 


ConnectorPatch 类 似 于 没有 文本 的 标注 。 虽 然 在 大 多 数 情况 下 建议 使 用 标注 函 
数 ， 但 是 当 您 想 在 不 同 的 轴 上 连接 点 时 ， ConnectorPatch 很 有 用 。 


from matplotlib.patches import ConnectionPatch 
xy = (0.2, 0.2) 
con = ConnectionPatch(xyA=xy, xyB=xy, coordsA="data", coordsB="d 
ata", 
axesA=ax1, axesB-ax2) 
ax2.add_artist(con) 


上 述 代码 连接 了 axi 中 数据 坐标 的 xy 点 ， 与 ax2 中 数据 坐标 的 xy 点 。 这 是 
个 简单 的 例子 。 


源 代 码 





虽然 ConnectorPatch 实例 可 以 添加 到 任何 轴 ， 但 您 可 能 需要 将 其 添加 到 绘图 顺 
序 中 最 新 的 轴 ， 以 防止 与 其 他 轴 重 三 。 


高 级 话题 


轴 域 之 间 的 缩放 效果 


mpl toolkits.axes grid.inset locator 定义 了 一 些 补丁 类 ， 用 于 互 连 两 个 轴 
Jo 理解 代码 需要 一 些 mpl 转换 如 何 工 作 的 知识 。 但 是 ， 利 用 它 的 方式 很 直接 。 


源 代码 
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定义 自 定义 盒 样式 
你 可 以 使 用 自 定 义 盒 样式 ， boxstyle 的 值 可 以 为 如 下 形式 的 可 调用 对 象 : 


def _ call (self, x0, yO, width, height, mutation_size, 
aspect ratio-1.): 
Given the location and size of the box, return the path of 
the box around it. 


- *xO*, *yO*, *width*, *height* : location and size of the 
box 
- *mutation size* : a reference scale for the mutation. 
- *aspect ratio* : aspect-ratio for the mutation. 
path - 
return path 


这 里 是 个 复杂 的 例子 : 
源 代 码 


标注 


1.0 


0.8 


0.6 


0.4 


0.2 
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但 是 ， 推 荐 你 从 matplotlib.patches.BoxStyle. Base 派生 ， 像 这 样 : 


from matplotlib.path import Path 
from matplotlib.patches import BoxStyle 
import matplotlib.pyplot as plt 


4 we may derive from matplotlib.patches.BoxStyle. Base class. 
# You need to override transmute method in this case. 


class MyStyle(BoxStyle. Base): 


A simple box. 


def — init (self, pad=0.3): 
The arguments need to be floating numbers and need to ha 
ve 
default values. 


*pad* 
amount of padding 


self.pad = pad 
super (MyStyle, self). init () 


def transmute(self, x0, yO, width, height, mutation size): 


Given the location and size of the box, return the path 
of 
the box around it. 


- *x0*, *yO*, *width*, *height* : location and size of 
the box 
- *mutation size* : a reference scale for the mutation. 


141 


Often, the *mutation size* is the font size of the text. 
You don't need to worry about the rotation as it is 
automatically taken care of. 


# padding 
pad - mutation size * self.pad 


# width and height with padding added. 
width, height = width + 2.*pad, \ 
height + 2.*pad, 


# boundary of the padded box 
x0, yO = xO-pad, yO-pad, 
X1, y1 = xO-width, yO + height 


cp = [(x0, yO), 
(x1, yO), (x1, y1), (x8, y1), 
(x0-pad, (y0*y1)/2.), (xO, yO), 
(x0, y0)] 

com = [Path.MOVETO, 
Path.LINETO, Path.LINETO, Path.LINETO, 
Path.LINETO, Path.LINETO, 
Path.CLOSEPOLY ] 

path = Path(cp, com) 


return path 
# register the custom style 
BoxStyle. style list['"angled"] = MyStyle 
plt.figure(i, figsize=(3,3)) 
ax = plt.subplot(iii) 
ax.text(0.5, 0.5, "Test", size=30, va="center", ha="center", rot 
ation-30, 
bbox=dict(boxstyle="angled, pad=0.5", alphaz0.2)) 
del BoxStyle._style_list["angled" ] 


plt.show( ) 


源 代 码 
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与 之 类 似 ， 您 可 以 定义 一 个 自 定 义 的 connectionstyle 和 一 个 自 定 义 
的 ArrowStyle ° 请 参阅 lib/matplotlib/patches.py 的 源 代码 ， 并 查看 每 个 
样式 类 是 如 何 定 义 的 。 


编写 数学 表达 式 


原文 : Writing mathematical expressions 
译 者 : 飞龙 
WB : CC BY-NC-SA 4.0 


你 可 以 在 任何 matplotlib 文本 字符 串 中 使 用 子 TeX 标记 ， 将 它 放 在 一 对 美元 符号 
E Ae 


注意 ， 你 不 需要 安装 TeX， 因 为 matplotlib 提供 了 自己 的 TeX 表达 式 解析 器 ， 布 局 
引擎 和 字体 。 布局 引擎 是 Donald Knuth 的 Tex 中 的 布局 算法 的 一 种 相当 直接 的 适 
配 版 ， 所 以 质量 是 相当 不 错 的 (matplotlib 还 为 那些 想 要 调用 TeX 生成 文本 的 人 提 
供 一 个 usetex 选项 (参见 使 用 LaTeX ERLA ) © 


任何 文本 元 素 都 可 以 使 用 数学 文本 。 你 应 该 使 用 原始 字符 串 (在 引号 前 面 加 一 

个 'r' ) ， 并 用 美元 符号 ( $ ) 包围 数学 文本 ， 如 TeX。 常规 文本 和 数学 文本 
可 以 在 同一 个 字符 串 内 交错 。 Mathtext 可 以 使 用 Computer Modern 字体 (来 自 
(La)TeX) ，STIX 字体 (为 与 Times 混合 使 用 而 设计 ) 或 你 提供 的 Unicode 字 
体 。 可 以 使 用 自 定 义 变 量 mathtext.fontset 选择 mathtext 字体 〈 请 参阅 自 定 义 
matplotlib ) 


x e 
(ES 


在 Python 的 lnarrowJ 构建 中 ， 如 果 使 用 STIX FA? MERE 
将 ps.fonttype 和 pdf.fonttype 设置 为 3 (默认 值 ) ， 而 不 是 42。 否则 
一 些 字 符 将 不 可 见 。 


下 面世 个 简单 的 例子 : 


# plain text 
plt.title('alpha » beta') 


生成 alpha > beta 。 


=x 


旦 是 这 个 : 


# math text 
plt.title(r'$Nalpha > \beta$') 


生成 (G5, 


正二 
Mathtext 应 该 放 在 一 对 美元 符号 ( $ ) 之 间 。 为 了 多 于 显示 货币 值 ， 例 
如 $ 100.00 > RET HPP RAPA GT > MEHMET EEA R 
元 符号 。 这 是 常规 TeX 的 一 个 小 改变 ， 其 中 非 数 学 文本 中 的 美元 符号 必须 被 
转 义 ( '$' ) œ 

De 

虽然 一 对 美元 符号 ( $ ) 内 的 语法 是 TeX 风格 的 ， 但 是 外 面 的 文本 不 是 。 特 
别 是 ， 字 符 : 

0 
在 TeX 中 的 数学 模 式 之 外 有 特殊 的 意 &3 e 因此， 根 


据 rcParam text.usetex 标志 这 些 字 符 的 表现 有 所 不 同 。 更 多 信息 请 参 
阅 usetex 教程 。 


下 标 和 上 标 
为 了 制作 下 标 和 上 标 ， 使 用 AN 符号 : 
r'$Nalpha i > \beta_i$' 


0; > 3; 


一 些 符 号 会 自动 将 它们 的 下 标 或 上 标 放 在 操作 符 的 底部 或 顶部 ， 例 如 ， 为 了 编写 0 
到 无 穷 的 “i 的 和 ， 你 可 以 : 


r'$Nsum [i-Oj)^Ninfty x i$' 


BIL > 7H A FeHE H X 


可 以 使 用 \frac{}{} ， \binomial{}{} 和 \stackrel{}{} 命令 分 别 创建 分 
Ao HAF RAS : 


r'$\frac{3}{4} \binom{3}{4} \stackrel{3}{4}$' 


P 
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请 注意 ， 在 分 数 周 围 放 置 圆 括号 和 花 括 号 需要 特别 注意 。 这 种 明显 的 方式 会 产生 太 
小 的 括号 : 


r'$(\frac{5 - \frac{1}{x}}{4})$' 





解决 方案 是 在 括号 前 面 加 上 \left 和 Nright 以 通知 解析 器 这 些 括 号 包含 整个 对 
A : 


r'$\left(\frac{5 - \frac{i}{x}}{4}\raight )$' 


根 却 
根 式 可 以 有 Nsqrt[]4) 产生 ， 例 如 


r'$\sqrt{2}$"' 


v2 
方 括号 内 可 以 (可 选 地 ) 设置 任何 底数 。 请 注意 ， 底 数 必 须 是 一 个 简单 的 表达 式 ， 
并 且 不 能 包含 布局 命令 ， 如 分 数 或 上 下 标 : 


r'$\sqrt[3]{x}$' 


字体 

用 于 数学 符号 的 默认 字体 是 斜体 。 
此 默认 值 可 以 使 用 mathtext.default  rcParam 更 改 。 这 是 非常 有 用 的 ， 
例如 ， 通 过 将 其 设置 为 regular ， 使 用 与 第 规 非 数学 文本 相同 的 字体 作为 数 
学 文本 。 

为 了 修改 字体 ， 例 如 ， 以 罗马 字体 编写 sin ， 使 用 字体 命令 来 闭合 文本 : 


r'$s(t) = \mathcal{A}\mathrm{sin}(2 \omega t)$' 


s(t) = Asin( 2wt) 


这 里 s fe 是 斜体 (默认 ) 的 变量 ， sin 是 罗马 字体 ， 振 幅 A 是 书法 字体 。 
注意 在 上 面 的 例子 中 ， A Fe sin 之 间 的 间距 被 挤 压 。 你 可 以 使 用 间距 命令 在 它 
们 之 间 添 加 一 些 空格 : 


s(t) = \mathcal{A}\/\sin(2 Nomega t) 


s(t) = Asin(2wt) 


所 有 字体 的 可 用 选项 为 : 
命令 结果 
\mathrm{Roman} Roman 
\mathit{Italic} Italic 
\mathtt{Typewriter} Typewriter 
\mathcal {CALLIGRAPHY } CALLIGRAPHY 


使 用 STIX 字体 时 ， 你 也 可 以 选择 : 


命令 结果 
\mathbb{blackboard} Diac» ard 
\mathrm{\mathbb{blackboard}} blackboard 
\mathfrak{Fraktur} ratur 
\mathsf{sansserif} sansserif 
\mathrm{\mathsf{sansserif}} sansserif 
\mathcircled{circled} EX a 


还 有 三 个 全 局 『 字 体 集 」 可 供 选 择 ， 它 们 使 用 matplotlibrc 中 
的 mathtext.fontset 参数 进行 选择 。 
cm : Computer Modern (TeX) 
DO 
R | | a,sin(27 fa; ) 
b= Ui +i 


stix : STIX (为 和 Times 混合 使 用 而 设计 ) 


及 IT ajsin(27fx; ) 


E 


stixsans : STIX sans-serif 


R || aisin(2zfx;) 


I= 6,3 


此 外 ， 你 可 以 使 用 \mathdefault{...} 或 其 别名 \mathregular{...} 来 使 用 用 
于 mathtext 之 外 的 第 规 文 本 的 字体 。 这 种 方法 有 一 些 限 制 ， 最 明显 的 是 ， 可 以 使 
用 很 少 的 符号 ， 但 可 用 于 将 数学 表达 式 与 图 中 的 其 他 文本 混合 。 


E GLA 


mathtext 还 提供 了 一 种 对 数学 公式 使 用 目 定 义 字 体 的 方法 。 这 种 方法 使 用 起 来 相当 
棘手 ， 应 该 看 做 为 有 耐心 的 用 户 准 备 的 试验 特性 。 通过 

将 rcParam mathtext.fontset 设置 为 custom ， 你 可 以 设置 以 下 参数 ， 这 些 参 
数控 制 用 于 特定 数学 字符 集 的 字体 文件 。 


参数 相当 于 


mathtext.it \mathit{} 默认 斜体 
mathtext.rm wathrm() 7 3444 (upright) 
mathtext.tt \mathtt{} 打字 机 (monospace) 
mathtext.bf \mathbf{} 粗 体 

mathtext.cal \mathcal{} 书法 

mathtext.sf \mathsf{} sans-serif 


每 个 参数 应 该 设置 为 fontconfig 字体 描述 符 (在 尚未 编写 的 字体 章节 中 定 
A) d 


所 使 用 的 字体 应 该 具有 Unicode 映射 ， 以 便 找 到 任何 非 拉 丁字 符 ， 例 如 希腊 语 。 
如 果 要 使 用 未 包含 在 自 定义 字体 中 的 数学 符号 ， 可 以 

将 rcParam mathtext.fallback to cm 设置 为 True ， 这 将 导致 自 定义 字体 中 
找 不 到 特定 字符 时 ， 数 学 文本 系统 使 用 默认 的 Computer Modern 字体 中 的 字符 。 


请 注意 ，Unicode 中 规定 的 数学 字形 随时 间 而 演进 ， 许 多 字体 的 字形 对 于 mathtext 
可 能 不 在 正确 位 置 。 

Jg kr 2 
重音 符号 


重音 命令 可 以 位 于 任何 符号 之 前 ， 在 其 上 添加 重音 。 他 们 中 的 一 些 些 拥有 较 长 和 较 
短 的 形式 。 





命令 结 采 
\acute a 或 \'a a 
\bar a ü 
\breve a cl 
\ddot a 3 \"a ü 
NE 2, NECI ü 
\grave a 3X Na ü 
\hat a 或 NAa 
\tilde a X \~a a 
\vec a 7 
\overline{abc} abc 


另外 有 两 个 特殊 的 重音 符号 ， 可 以 自动 调整 为 符号 的 宽度 : 


> 
+> 


结 采 
\widehat {xyz} TUZ 


\widetilde{xyz} TUZ 


当 把 重音 放 在 小 写 的 i 和 j 上 时 应 该 小 心 。 注意 下 面 的 \imath 用 来 避免 i 上 
Uu: 


r"$\hat iN N \hat \imath$" 


符号 


你 也 可 以 使 用 更 大 量 的 TeX 符号 ， 比 
如 Ninfty ° \leftarrow ^ \sum ， \int ° 


小 写 布 腊 字 
母 

Om \al v X Ó F 
' Nalpha Nbeta \chi ^ delta Ndigamma 
F 5, 
\epsilon 7 \eta ' Ngamma ^ Niota " kappa 
A | , C 
MEETS I^ Nmu v ET 4 Nomega "5 Nphi 
T \pi V psi "É \rho 7 \sigma 7 Ntau 
有 i! F AX T 

\theta \upsilon \varepsilon \varkappa \varphi 
nT O . |) £ . 
\varpi \varrho ^ Warsigma \vartheta ^ XI 


: \zeta 


大 写 布 腊 字 
B 
A | A () 中 
\Delta \Gamma \Lambda “© NOmega \Phi IT \pi 
uh e Y — l Ó 
J = 
9 \Psi \Sigma \Theta NUpsilon = MX \mho 
V 
\nabla 
项 伯 来 文 
N \aleph + \beth 1 \daleth 4 \gimel 
分 隔 符 
| 小 tt x 
/ [ \Downar row NUparrow Vert 
v Y l L 
\rangle Nie eal 1 eie \ulcorner \uparrow 
| 1 
| Wert i VE iN NE 
大 型 符号 
| | | (T 
f| U © Q9 
\bigcap \bigcup \bigodot \bigoplus \bigotimes 
出 V 人 ll | 
\biguplus \bigvee \bigwedge \coprod \int 


IT 


\prod 


f \oint 


2. Nsum 


标准 函数 名 称 


Pr \pr pese pum ponet 
as Narg COS \cos cosh \cosh cot Ncot 
coth Ryan CSC \csc deg «aeg det \det 
dim \dim EXP \exp ecd \ged hom \hom 
inf \inf ker \ker lg \lg li \lim 
pM poem i Vim l^ Vlog 
max Nmax Inl] \min sec \sec SIn Nsin 
sinh \sinh aE a ip tan \tan tanh \tanh 
二 元 运 骨 符 和 关系 得 

a 
<= \Bumpeq U Cap mM \Cup 
= \Doteq x] \Join © \Subset 
3 \Supset I= Nvdash IF NVvdash 
= Napprox = \approxeg = Nast 
— \asymp 3 Nbackepsilon ~» \backsim 


= \backsimegq 


! \between 


P^, 
rd z 


AAGE FAA cles 

lE 

Ld \boxminus 

e \bullet 
\cdot 

= \coloneq 

z \curlyeqprec 


^ Ncurlywedge 


^ \barwedge 


— \bigcirc 


\blacktriangleleft 


PÀ \bowtie 
FH \boxplus 
=~ \bumpeg 
NCITC 
\cong 


= \curlyeqsucc 


! Ndag 


Nbecause 


4, 


v \bigtriangledown 


> 


\blacktriangleright 
L] \boxdot 

È] \boxtimes 

Bl v: 

= \circeq 

\cup 


Y \curlyvee 


a 


\dashv 


+ \ddag 
Æ \divideontimes 
i Ndotplus 


=: Neqcolon 


AA, 


\eqslantless 


\frown 


Ww 


Ngegslant 


Ngnapprox 


HN XY 


Ngtrapprox 


AIV 


Ngtreqqless 


Nin 
\leq 


Nlessapprox 


Nlesseqqgtr 
=) sb 

= Nlneqq 

| Nmid 

H^ \nvDash 

= \ncong 

T \neq 

> \ngtr 
\nless 
\nparallel 


3. 
it 
© \nsubset 
乃 


\nsupset 


© \diamond 


= \doteg 


zl 


Ndoublebarwedge 


èl 


Negsim 
= \equiv 
= \geq 
= \gg 

> 

= \gneqq 


> \gtrdot 


z Ngtrless 
| Nintercal 
三 \leqq 

= \lessdot 
S \lessgtr 
< \1]1l 

$ Nlnsim 


F models 


H^  NnVdash 


H- 


\ne 

* \nequiv 
= \Ni 

1 \nmid 

T \nprec 

g \nsubseteq 
2 


\nsupseteq 


= \div 

= \doteqdot 

=x \eqcirc 

> Negslantgtr 

= \fallingdotseg 
= \geqq 

cxx Nggg 

z Ngnsim 
Ngtregless 
Ngtrsim 

^ \leftthreetimes 
Nleqslant 


Nlesseqgtr 


Nlesssim 


PEA 


\lnapprox 


\ltimes 


HW! X 


\mp 

+ \napprox 
\neq 

ra \ngeq 
£ \nleq 

= \notin 
"^ \nsim 

\nsucc 


\ntriangleleft 


\ntrianglelefteq 
F \nvDash 
\ominus 


\otimes 


M \pitchfork 


aA 


\precapprox 
= 

* \precnapprox 
X \propto 


^l \rtimes 


/ \slash 
LI \sqcup 
= \sqsubseteq 
= \sqsupseteq 


= \subseteq 


\subsetneqq 


Nsucccurlyeq 


\succnsim 


= \supseteq 


m 
= \supsetneqq 
T 


Ntop 
= \triangleg 
出 \uplus 
<j 
\vartriangleleft 
\vee 
C \wr 


P \ntriangleright 


^ wnvdash 


Noplus 
| Nparallel 
EE Npm 
Npreccurlyeq 
二 Nprecnsim 
A \rightthreetimes 
~ sim 
— \smile 
上- \sqsubset 
-] \sqsupset 


* \star 


1A 


\subseteqq 


"- Ese 


\succeq 
\succsim 
\supseteqq 
\therefore 
I \triangleleft 
^ Ntriangleright 

\vDash 


\vartriangleright 


V ^ Nveebar 


n 


v 


IV 


名 


Nntrianglerighteq 


Nodot 
Noslash 
Nperp 
\prec 
Nprecegq 
Nprecsim 
\risingdotseq 
Nsimeg 
\sqcap 
\sqsubset 
\sqsupset 
\subset 
\subsetneq 
\succapprox 
\succnapprox 
\supset 
\supsetneq 
\times 


Ntrianglelefteq 
Ntrianglerighteq 


Nvarpropto 
Nvdash 


Nwedge 


I 
y \Downarrow 


= NLeftrightarrow 
= \Longleftarrow 
— > \Longrightarrow 
^ \Nearrow 


一 \Rightarrow 
| INRSh 

£ \swarrow 

i NUpdownarrow 

O \circlearrowright 
ry 


\curvearrowright 
-> \dashrightarrow 
H \downdownarrows 
| \downharpoonright 
— \hookrightarrow 
“— \leftarrow 
*- Aleftharpoondown 
— \leftleftarrows 
= \leftrightarrows 
*^* \leftrightsquigarrow 
*— \longleftarrow 
——* \longmapsto 
“+ \looparrowleft 
— \mapsto 
+ \nLeftarrow 
> \nRightarrow 


= \nleftarrow 


“= \Leftarrow 


= \Lleftarrow 


——7 \Longleftrightarrow 
1 wish 


ES NNwar r ow 


=> \Rrightarrow 


* \Searrow 

人 NUparrow 

© \circlearrowleft 
£^ 


Ncurvearrowleft 


*- Adashleftarrow 

* Ndownarrow 

| Ndownharpoonleft 

— \hookleftarrow 

^ \leadsto 

<< \leftarrowtail 

+ \leftharpoonup 

** \leftrightarrow 
= \leftrightharpoons 
— \leftsquigarrow 
*—* \longleftrightarrow 
— + \longrightarrow 
+ \looparrowright 

— \multimap 


=> \nLeftrightarrow 


\nearrow 


** A\nleftrightarrow 


7* \nrightarrow 


—* \rightarrow 

^7 Nrightharpoondown 

— Euilgcllestabgws 
Nrightleftharpoons 

= \rightrightarrows 


-> \rightsquigarrow 


"4 NSwar row 


+ Ntwoheadleftarrow 


a 


Nuparrow 


Eus 


* Nupdownarrow 


| Nupharpoonright 


H 


~ Anwarrow 

+ \rightarrowtail 

—s \rightharpoonup 
\rightleftarrows 
Nrightleftharpoons 


Nrightrightarrows 
N \searrow 
— \to 


> Ntwoheadrightarrow 


us 


~ Nupdownarrow 
1 \upharpoonleft 


TT Nupuparrows 


2 Game 

h wRe 

' Nbackprime 

À \blacktriangle 
Ncheckmark 

* \clubsuit 
Nddots 

Ü Nemptyset 

” \flat 


-m 
(* 1] 


\heartsuit 
I \iint 
x \infty 
A \measuredangle 
A \nexists 
f \prime 
14 \sphericalangle 


© \varnothing 


V^ Nwp 


9 AS 
* \bigstar 
Y Nblacktriangledown 


® \circledR 


Ca 


Ncomplement 
Ndiamondsuit 
Ó Neth 

V \forall 

hh \hslash 

I \iint 

J \jmath 

^ \natural 

Í? nonum 

- Nsharp 

D SS 

& \vartriangle 


¥ \yen 


d \Finv 

| \p 

Z \angle 

a \blacksquare 
\cdots 

(S \circleds 

© \copyright 


E \ell 


| Nexists 


 Nhbar 
lll Sab bli 
t Nimath 
\ldots 
~ \neg 
d \partial 
A \spadesuit 
V Ntriangledown 


Nvdots 


如 果 特 定 符号 没有 名 称 〈 对 于 STIX 字体 中 的 许多 较为 模糊 的 符号 也 是 如 此 ) ， 也 


可 以 使 用 Unicode 字符 : 


ur'$\u23ce$' 


示例 


下 面 是 个 示例 ， 在 上 下 文中 展示 了 许多 这 些 特性 。 


VOITS umvJ 


import numpy as np 
import matplotlib.pyplot as plt 


np.arange(0.0, 2.0, 0.01) 
np.sin(2*np.pi*t) 


.plot(t,s) 

.title(r'$Nalpha i > \beta_i$', fontsize-20) 

.text(1, -0.6, r'$Nsum ([i-0)^NMinfty x i$', fontsize-20) 
.text(0.6, 0.6, r'$\mathcal{A}\mathrm{sin}(2 Nomega t)$', 


fontsize-20) 


.Xlabel('time (s)') 
.Ylabel('volts (mV)') 
. show( ) 


qi > Bi 
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使 用 LaTeX i£ MA 


原文 : Text rendering With LaTeX 
译 者 : 飞龙 
WU: CC BY-NC-SA 4.0 
Matplotlib 可 以 选择 使 用 LaTeX 来 管理 所 有 文本 布局 。 此 选项 可 用 于 以 下 后 端 : 


e Agg 
e PS 
e PDF 


LaTeX 选项 通过 在 rc 设置 中 设置 text.usetex:True 来 激活 。 使 用 matplotlib 
的 LaTeX 支持 的 文本 处 理会 慢 于 matplotlib 的 非常 强大 的 mathtext， 但 是 更 灵活 ， 
因为 可 以 使 用 不 同 的 LaTeX 包 (字体 包 ， 数 学 包 等 ) 。 结果 会 十 分 惊人 人， 特别 是 
当 你 在 图 形 中 使 用 和 主 文档 相同 的 字体 。 


Matplotlib 的 LaTeX 支持 需要 可 用 的 LaTeX 安装 版 本 ，dvipng (可 能 包括 在 你 的 
LaTeX 安装 中 ) 和 Ghostscript (建议 使 用 GPL Ghostscript 8.60 或 更 高 版 本 ) 。 
这 些 外 部 依赖 的 可 执行 文件 必须 都 位 于 你 的 PATH 中 。 


有 几 个 选项 需要 提 及 ， 可 以 使 用 rc 设置 更 改 它们 。 这 里 是 一 
个 matplotlibrc 示例 文件 : 


font.family : Serif 

font.serif : Times, Palatino, New Century Schoolbook, Bo 
okman, Computer Modern Roman 

font.sans-serif : Helvetica, Avant Garde, Computer Modern San 
s serif 

font.cursive : Zapf Chancery 

font.monospace : Courier, Computer Modern Typewriter 
text.usetex : true 


每 个 系列 中 的 第 一 个 有 效 字体 是 要 加 载 的 字体 。 如 果 未 指定 字体 ， 则 默认 使 用 
Computer Modern 字体 。 所 有 其 他 字体 是 Adobe 字体 。Times 和 Palatino 每 个 
都 有 自己 附带 的 数学 字体 ， 而 其 他 Adobe 衬 线 字体 使 用 Computer Modern % 4 F 
体 。 有 关 更 多 详细 信息 ， 请 参阅 PSNFSS 文档 。 


要 使 用 LaTeX 并 选择 Helvetica 作为 默认 字体 ， 但 不 编辑 matplotlibrc > 1% 
用 : 


使 用 LaTeX 演 染 文本 


from matplotlib import rc 
rc('font',**['family':'sans-serif','sans-serif':['Helvetica']]) 
## for Palatino and other serif fonts use: 
#rc('font',**{'family':'serif', 'serif':['Palatino' ]}) 
rc('text', usetex=True) 


这 里 是 标准 的 示例 ， tex demo.py 


Demo of TeX rendering. 


You can use TeX to render all of your matplotlib text if the rc 

parameter text.usetex is set. This works currently on the agg a 

nd ps 

backends, and requires that you have tex and the other dependenc 

ies 

described at http://matplotlib.org/users/usetex. html 

properly installed on your system. The first time you run a scr 

ipt 

you will see a lot of output from tex and associated tools. The 
next 

time, the run may be silent, as a lot of the information is cach 

ed in 

~/.tex.cache 


import numpy as np 
import matplotlib.pyplot as plt 


# Example data 
np.arange(0.0, 1.0 + 0.01, 0.01) 
np.cos(4 * np.pi * t) + 2 


plt.rc('text', usetex-True) 
plt.rc('font', family='serif' ) 
plt.plot(t, s) 


plt.xlabel(r'\textbf{time} (s)') 
plt.ylabel(r'\textit{voltage} (mV)',fontsize-16) 
plt.title(r"NTeXN is Number " 

r'$NdisplaystyleNsum (n-1)^NinftyNfrac(-e^(iNpi)(2^n) 
qn 

fontsize-16, color-'gray') 
4 Make room for the ridiculously large title. 
plt.subplots adjust(topz0.8) 


plt.savefig('tex demo') 
plt.show() 
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要 注意 数学 显示 模式 〈 $$ e=mcA2 $$ ) 是 不 支持 的 ， 但 是 添加 命 
4 Ndisplaystyle 之 后 会 产生 相同 结果 ， 就 像 tex_demo.py 中 那样 。 


注意 


些 字符 在 Tex 中 需要 特别 转 义 ， 例 如 
a a 


所 以 ， 这 些 字 符 会 根据 rcParam text.usetex 标志 位 而 表现 不 同 。 


在 TeX 中 使 用 Unicode 


也 可 以 在 LaTeX 文本 管理 器 中 使 用 unicode 字符 串 ， 
从 tex unicode demo.py 中 获取 的 示例 : 


# -*- coding: utf-8 -*- 

This demo is tex demo.py modified to have unicode. See that file 
for 

more information. 


from | future import unicode literals 

import numpy as np 

import matplotlib 
matplotlib.rcParams['text.usetex'] - True 
matplotlib.rcParams['text.latex.unicode'] - True 
import matplotlib.pyplot as plt 


plt.figure(i, figsize=(6, 4)) 

ax = plt.axes([0.1, 0.1, 0.8, 0.7]) 
np.arange(0.0, 1.0 + 0.01, 0.01) 
np.cos(2*2*np.pi*t) + 2 
plt.plot(t, s) 


plt.xlabel(r'\textbf{time (s))') 

plt.ylabel('\\textit{Velocity (NuOOBO/sec))', fontsize-16) 

plt.title(r'NTeXN is Number $\displaystyle\sum_{n=1}4\infty' 
r'\frac{-er{i\pi}}{24n}$!', fontsize-16, color-'r') 

plt.grid(True) 

plt.show() 
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Postscript 选项 


AY Amy Vt AS a LaTeX 文档 中 的 postscript 封装 文件 ，matplotlib 的 默认 行 
为 是 提取 输出 ， 这 会 删除 LaTeX 使 用 的 一 些 postscript 操作 符 ， 这 些 操 作 符 在 eps 
文件 中 是 非法 的 。 此 步骤 产生 的 结果 对 于 一 些 用 户 可 能 是 不 可 接受 的 ， 因 为 文本 被 
粗略 地 光栅 化 并 且 被 转换 为 位 图 ， 而 不 像 标准 Postscript 那样 是 可 缩放 的 ， 并 且 文 
本 是 不 可 搜索 的 。 一 种 解决 方法 是 在 你 的 rc 设置 中 将 ps.distiller.res 设置 
为 较 高 的 值 (可 能 为 6000) ， 这 将 产生 较 大 的 文件 ， 但 可 能 看 起 来 更 好 并 能 够 合 
理 缩放 。 更 好 的 解决 方法 需要 Poppler 或 Xpdf， 可 以 通过 

将 ps.usedistiller rc 设置 更 改 为 xpdf 来 激活 。 此 替代 方案 产生 postscript 
而 不 光栅 化 文本 ， 因 此 它 能 够 正确 缩放 ， 可 以 在 Adobe Illustrator 中 编辑 ， 并 搜 

索 pdf 文档 中 的 文本 。 


可 能 的 问题 


e 在 Windows 上 ， 可 能 需要 修改 PATH 环境 变量 来 包含 latex，dvipng 和 
ghostscript 可 执行 文件 的 目录 。 详 细 信 息 请 参阅 环境 变量 和 在 Windows 中 设 
置 环境 变量 。 

e 使 用 MIKTeX 与 Computer Modern 字体 ， 如 果 你 得 到 否 怪 的 *Agg 和 PNG 结 
果 ， 访 问 MiKTeX/Options 并 更 新 你 的 格式 文件 。 

e 字体 在 屏幕 上 看 起 来 粮 糕 。 你 可 能 正在 运行 Mac OS ， 在 mac 上 的 老 版 本 
dvipng 运行 着 一 些 有 趣 的 事情 。 在 你 的 matplotlibrc 文件 中 设 
置 text.dvipnghack:True 。 

e 在 Ubuntu 和 Gentoo 上 ，texlive 基本 安装 不 附带 type1cm 包 。 你 可 能 需要 安 
装 一 些 额外 的 包 ， 来 获得 所 有 与 其 它 LaTeX 分 发 版 捆绑 的 特性 。 

e matplotlib 已 经 取得 了 一 些 进展 ， 所 以 可 以 直接 使 用 dvi 文件 进行 文本 布局 。 
这 允许 LaTeX 用 于 具有 pdf 和 svg 后 端的 文本 布局 ， 以 及 *Agg 和 PS 后 
端 。 在 将 来 ，LaTeX 安装 可 能 是 唯一 的 外 部 依赖 。 


故障 排除 


e 尝试 删除 .matplotlib/tex.cache 目录 。 如 果 你 不 知道 .matplotlib 在 
哪里 ， 请 参见 matplotlib 配置 和 缓存 目录 位 置 。 

e 确保 LaTeX > dvipng 和 ghostscript 都 正常 工作 ， 并 存在 于 你 的 PATH 中 。 

e 确保 你 想 要 做 的 事情 在 LaTeX 文档 中 可 实现 ， 你 的 LaTeX 语法 是 有 效 的 ， 并 
且 你 正在 使 用 原始 字符 串 ， 如 果 必 要 ， 以 避免 意外 的 转 义 原 列 。 

e 邮件 列表 上 报告 的 大 多 数 问题 已 通过 升级 Ghostscript 来 清除 。 如 果 可 能 的 
话 ， 请 尝试 升级 到 最 新 版 本 ， 然 后 向 列表 报告 问题 。 

e text.latex.preamble rc 设置 不 受 官 方 支持 。 此 选项 提供 了 大 量 的 灵活 性 
和 导致 问题 的 许多 方法 。 请 在 向 邮件 列表 报告 问题 之 前 禁用 此 选项 。 

e 如 果 仍 需要 帮助 ， 请 参阅 获取 玫 助 。 


XeLaTeX/LuaLaTeX 设置 


原文 : Typesetting With XeLaTeX/LuaLaTeX 
译 者 : 飞龙 
Wi: CC BY-NC-SA 4.0 


使 用 pgf 后 端 matplotlib 可 以 将 图 形 导 出 为 可 以 使 用 pdflatex，xelatex 或 
lualatex 处 理 的 pgf 绘图 命令 。XeLaTeX 和 LuaLaTeX 具有 完整 的 unicode 支持 ， 
可 以 使 用 安装 在 操作 系统 中 的 任何 字体 ， 利 用 OpenType > AAT 和 Graphite 的 高 
级 排版 功能 。 由 plt.savefig('figure.pgf') 创建 的 Pgf 图 片 可 以 作为 原始 命 
44A 8| LaTeX 文档 中 。 图 形 也 可 以 通过 切换 到 该 后 端 ， 直 接 编译 并 使 

用 plt.savefig('figure.pdf') 保存 到 PDF» 


matplotlib.use('pgf') 


或 者 为 处 理 PDF 输出 而 注册 它 : 


from matplotlib.backends.backend pgf import FigureCanvasPgf 
matplotlib.backend bases.register backend( 'pdf', FigureCanvasPgf 


) 


第 二 种 方法 允许 你 继续 使 用 第 规 的 交互 式 后 端 ， 并 从 图 形 用 户 界 面 保 行 xelatex， 
lualatex 或 pdflatex 编译 的 PDF 文件 。 


Matplotlib 的 pgf 支持 需要 最 新 的 LaTeX 安装 ， 包 括 TikZ/PGF 软件 包 (如 
TeXLive) ， 最 好 安装 XeLaTeX 或 LuaLaTeX。 如 果 你 的 系统 上 存在 pdftocairo 或 
ghostscript， 也 可 以 选择 将 图 形 保存 为 PNG 图 像 。 所 有 应 用 程序 的 可 执行 文件 必 
须 位 于 PATH 中 。 


控制 pgf 后 端 行 为 的 Rc 参数 : 


参数 文档 
pgf.preamble 包含 在 LaTeX 序言 中 的 行 
pgf.rcfonts 使 用 fontspec 软件 包 从 rc 参数 设置 字体 


pgf.texsystem xelatex (U) ， lualatex 或 者 pdflatex 


GER 


TeX 定义 了 一 系列 特殊 字符 ， 例 如 : 


# 书 %R&~_ ^N(J 


通常 ， 这 些 字符 必须 正确 转 义 。 一 些 字符 (00 ^oc 9€) 会 自动 在 数学 环 
境 之 外 转 义 。 


字体 规定 


用 于 获取 文本 元 素 大 小 ， 或 将 图 形 编译 为 PDF 的 字体 通常 在 matplotlib rc 参数 中 
Lo 你 还 可 以 通过 清 

除 font.serif ， font.sans-serif 3X font.monospace 的 列表 来 使 用 LaTeX 
默认 的 Computer Modern 字体 。 请 注意 ， 这 些 字体 的 字形 履 盖 范围 非常 有 限 。 如 
果 要 保留 Computer Modern 字体 ， 但 需要 扩展 Unicode 编码 支持 ， 请 考虑 安装 
Computer Modern Unicode 字体 CMU Serif * CMU Sans Serif 等 。 


保存 到 ,pgf N° matplotlib 用 于 图 形 布局 的 字体 配置 包含 在 文本 文件 的 标题 中 。 


# -*- coding: utf-8 -*- 


import matplotlib as mpl 
mpl.use("pgf") 
pgf with rc fonts - ( 


"font.family": "serif", 
“font serum [], 4 use latex default seri 
f font 


"font.sans-serif": ["DejaVu Sans"], Use a specific sans-se 
rif font 


j 


mpl.rcParams.update(pgf with rc fonts) 


import matplotlib.pyplot as plt 
plt.figure(figsize=(4.5,2.5)) 

plt.plot(range(5)) 

plt.text(0.5, 3., "serif") 

plt.text(0.5, 2., "monospace", family-"monospace") 
plt.text(2.5, 2., "sans-serif", family="sans-serif") 
plt.text(2.5, 1., "comic sans", family="Comic Sans MS") 
plt.xlabel(u"u is not $\\mu$") 

plt.tight layout(.5) 


monospace ~ sans-serif 


comic sans 





2.0 "e | 
b. 0.5 1.0 1.5 2.0 2.0 3.0 3.0 1. 


u is not p 


Ae LS 


通过 将 你 的 命令 添加 到 友 言 中 ， 你 可 以 完全 自 定 义 它 。 如 果 要 配置 数学 字体 (例如 
使 用 unicode-math) 或 加 载 其 他 软件 包 ， 请 使 用 pgf.preamble 和 参数。 此外， 如 
果 你 想 目 己 做 字体 配置 ， 而 不 是 使 用 rc 参数 中 指定 的 字体 ， 请 确保 禁 

用 pgf.rcfonts ° 





# -*- coding: utf-8 -*- 
from | future _ import (absolute import, division, print functio 


n, 


unicode literals) 


import six 


import matplotlib as mpl 
mpl.use("pgf") 
pgf with custom preamble = { 


nts 


rs 


e» 


} 
mpl. 


"font.family": "serif", # use serif/main font for text eleme 


"text.usetex": True, # use inline math for ticks 
"pgf.rcfonts": False, # don't setup fonts from rc paramete 


"pgf.preamble": [ 
"\\usepackage{units}", # load additional packag 


"\\usepackage{metalogo}", 

"\\usepackage{unicode-math}", # unicode math setup 
r"\setmathfont{xits-math.otf}", 

r"\setmainfont{DejaVu Serif)", # serif font via preamble 


] 


rcParams.update(pgf with custom preamble) 


import matplotlib.pyplot as plt 


plt 
plt 
plt 
plt 
plt 
plt 


.figure(figsizez(4.5,2.5)) 

.plot(range(5)) 

.Xlabel("unicode text: a, y, €, ü, \\unitfrac[10]{°}{um}") 
.Ylabel("\\XeLaTex" ) 

.legend(["unicode math: $A-» i^o pg i^2$'"]) 

.tight layout(.5) 





(). 
%.0 0.5 lO 15 20 25 30 35 40 
unicode text: a, y, €, U, 10 um 


选择 TeX 系统 


matplotlib 使 用 的 TeX 系统 由 pgf.texsystem 参数 选择 。 可 能 的 值 
为 xelatex (默认 值 ) ， lualatex 和 pdflatex 。 请 注意 ， 当 选 
择 pdflatex 时 ， 必 须 在 友 言 中 配置 字体 和 Unicode 处 理 。 


# -*- coding: utf-8 -*- 


import matplotlib as mpl 
mpl.use("pgf") 
pgf with pdflatex = { 
"pgf.texsystem": "pdflatex", 
"pgf.preamble": [ 
r"Nusepackage [utf8x]1inputenc)", 
r'\usepackage[T1|]{fontenc}", 
r'"\usepackage{cmbright}", 
] 
} 
mpl.rcParams.update(pgf with pdflatex) 
import matplotlib.pyplot as plt 
plt.figure(figsize=(4.5,2.5)) 
plt.plot(range(5) ) 
plt.text(0.5, 3., "serif", family="Serif") 
plt.text(0.5, 2., "monospace", family="monospace" ) 
plt.text(2.5, 2., "sans-serif", family="Sans-serif") 
plt.xlabel(u"u is not $NNmu$") 
plt.tight layout(.5) 


4.0 

3.5 

30 serif 

2.5 

20 monospace sans-serif 


1.5 
1.0 
0.5 





BU 05 10 15 20 25 30 35 40 
uis not u 


故障 排除 


请 注意 ， 在 一 些 Linux 发 行 版 和 MiKTeX 安装 中 发 现 的 TeX 包 已 经 过 时 了 。 确 保 更 
新 你 的 软件 包 目 录 并 升级 或 安装 最 新 的 TeX 发 行 版 。 在 Windows 上 ， 可 能 需要 修 
PL PATH 环境 变量 来 包含 latex，dvipng 和 ghostscript 可 执行 文件 的 目录 。 详 细 信 


息 请 参阅 环境 变量 和 在 窗口 中 设置 环境 变量 。 Windows 上 的 限制 会 导致 后 端 保留 
由 应 用 程序 打开 的 文件 句柄 。 因 此 ， 可 能 无 法 删除 相应 的 文件 ， 直 到 应 用 程序 关闭 
(参见 #1324 ) 。 有 时 保存 到 png 图 像 的 图 形 中 的 字体 非常 糟糕 。 这 在 
pdftocairo 工具 不 可 用 ， 并 且 ghostscript 用 于 pdf 到 png 的 转换 时 发 生 。 确保 你 
想 要 做 的 事情 在 LaTeX 文档 中 可 实现 ， 你 的 LaTeX 语法 是 有 效 的 ， 并 且 你 正在 使 
用 原始 字符 串 ， 如 果 必 要 的 话 ， 避 免 意外 的 转 义 夺 列 。 pgf.preamble rc 设置 提 
供 了 大 量 的 灵活 性 ， 以 及 导致 问题 的 许多 方法 。 遇 到 问题 时 ， 尝 试 最 小 化 或 禁用 目 
定义 序言 。 配 置 unicode-math 环境 可 能 有 点 棘手 。 例 如 TeXLive 分 发 版 提供 了 一 
组 通常 不 在 系统 学 围 内 安装 的 数学 字体 。 与 LuaLatex 不 同 的 是 ，XeTeX 不 能 根据 
名 字 找 到 这 些 字 体 ， 这 就 是 你 可 能 必须 指定 \setmathfont{xits-math.otf} ， 
而 不 是 Nsetmathfont(XITS Math) 的 原因 ， 或 者 使 字体 可 用 于 你 的 操作 系统 。 更 
多 详细 信息 请 参阅 这 个 tex.stackexchange.com 的 问题 。 如果 matplotlib 使 用 的 
字体 配置 不 同 于 你 的 LaTeX 文档 中 的 字体 设置 ， 则 导入 图 形 中 的 文本 元 各 对 齐 可 能 
会 关闭 。 如 果 你 不 确定 matplotlib 用 于 布局 的 字体 ， 请 检查 ,pgf 文件 的 标题 。 如 
果 图 中 有 很 多 对 象 ， 矢 量 图 像 和 .pgf 文件 可 能 变 得 腔 肿 。 这 可 能 是 图 像 处 理 或 非 
常 大 的 散 点 图 的 情况 。 在 极端 情况 下 ， 这 可 能 导致 TeX 内 存 不 
X : TeX capacity exceeded, sorry (TeX 容量 过 大 ， 对 不 起 ) 。 你 可 以 配置 
LaTeX 来 增加 可 用 于 生成 .pdf 图 像 的 内 和 存量， 请 
见 tex.stackexchange.com 上 讨论 的 问题 。 另 一 种 方法 是 使 
用 rasterized = True 关键 字 ， 或 者 根据 本 示例 
的 .set rasterized(True) TRACI 图形 的 某 些 导致 问题 部 分 。 如 果 你 仍 需 
要 帮助 ， 请 参阅 获取 帮助 。 


el 3 
48 X Jl E 
原文 : Specifying Colors 
译 者 : 飞龙 
协议 : CC BY-NC-SA 4.0 
在 matplotlib 的 几乎 所 有 地 方 ， 用 户 都 可 以 指定 颜色 ， 它 可 以 以 如 下 形式 提供 : 


e RGB 或 者 RGBA 浮 点 值 元 组 ， [0, 1] 之 间 ， 例 如 (0.1, 0.2, 0.5) 或 
者 (0.1, 0.2, 0.5, 0.3) 。 


RGB 或 者 RGBA 十 六 进 制 字符 串 ， 例 如 HOFOFOF 或 者 #OFOFOFOF ° 
e [0, 1] ZANE AMN TARR? MTATA Plt 0.5 。 


@ {'b', jo E du pour 'm', DV 'k', 'w' } 之 一 。 
e X11/CSS4 Jf BZ fk o 
e XKCD i 6,2. — * YA 'xkcd:' 为 前 级 ， 例 如 'xkcd:sky blue' 。 


e "CO Fe CI Co CS ro MCI Mo QUAM Z^ 


— O 


e {'tab:blue', 'tab:orange', 'tab:green', 'tab:red', 'tab:purple' 
之 一 。 这 是 T10 调 色 板 的 Tableau 颜色 (默认 的 色相 环 ) e 


所 有 颜色 字符 串 都 是 大 小 写 敏感 的 。 


CN ği é $43 


PET VATA ey PEACE GAH c[0-9] 的 字符 串 来 指定 。 这 可 以 在 任何 当前 接受 
闫 色 的 地 方 传 递 ， 并 且 可 以 在 matplotlib.Axes.plot 的 format-string 中 用 
作 " 单 个 字符 颜色 ”。 


单个 数字 是 默认 属性 环 的 索引 
( matplotlib.rcParams['axes.prop cycle'] ) 。 如果 属性 环 不 包 
括 'color' ， 则 返回 黑色 。 在 创建 艺术 家 时 会 对 颜色 求 值 。 例 如 : 


import numpy as np 

import matplotlib.pyplot as plt 
import matplotlib as mpl 

th = np.linspace(0, 2*np.pi, 128) 


def demo(sty): 
mpl.style.use(sty) 
fig, ax = plt.subplots(figsize=(3, 3)) 
ax.set title('style: {!r}'.format(sty), color='CO' ) 
ax.plot(th, np.cos(th), 'Ci', label-'C1') 
ax.plot(th, np.sin(th), 'C2', label='C2') 
ax.legend() 


demo( 'default') 


style: 'default 





" 


style: ‘seaborn 


0.5 


0.0 
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) 


指定 
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E X 3. matplotlib 


原文 : Customizing matplotlib 
译 者 : 飞龙 
Wu: CC BY-NC-SA 4.0 


使 用 样式 表 自 定义 绘图 


style 包 为 多 于 切换 的 绘图 『 样 式 」 增 加 了 支持 ， 它 们 与 matplotlibrc 文件 参 
数 相同 。 


有 一 些 预 定义 样式 由 matplotlib 提供 。 例 如 ， 有 一 个 名 为 『ggplotJ 的 预定 义 
样式 ， 它 模拟 ggplot (R 的 一 种 流行 的 绘图 软件 包 ) 的 美学 。 为 了 使 用 此 样 


式 ， 只 需 添加 : 


>>> import matplotlib.pyplot as plt 
>>> plt.style.use('ggplot') 


为 了 列 出 所 有 可 用 样式 ， 使 用 : 


>>> print(plt.style.available) 


定义 你 自己 的 样式 


你 可 以 创建 自 定义 样式 ， 并 通过 以 样式 表 的 路 径 或 URL 调用 style.use 来 使 用 它 
们 。 或 者 ， 如 果 将 <style-name> mplstyle 文件 添加 

到 mpl configdir /stylelib 中 ， 你 可 以 通过 调 

用 style.use(«style-name») 重复 使 用 自 定 义 样式 表 。 默认 情况 

下 mpl configdir 应 该 是 -/.config/matplotlib ， 但 你 可 以 使 

用 matplotlib.get configdir() 检查 你 的 位 置 ， 你 可 能 需要 创建 这 个 目录 。 请 
注意 ， 如 果 样 式 具 有 相同 的 名 称 ，mpl configdir/stylelib 中 的 自 定 义 样式 表 
将 履 盖 由 matplotlib 定义 的 样式 表 。 


例如 ， 你 可 能 想 要 使 用 以 下 命令 创 
建 mpl configdir/stylelib/presentation.mplstyle 


axes.titlesize : 24 
axes.labelsize : 20 
lines.linewidth : 3 
lines.markersize : 10 
xtick.labelsize : 16 
ytick.labelsize : 16 


然后 ， 当 你 想 要 将 一 个 为 纸张 设计 的 地 图 迁移 到 演示 文档 中 时 ， 你 可 以 添加 : 


>>> import matplotlib.pyplot as plt 
>>> plt.style.use( presentation!) 


组 合 样式 
样式 表 为 组 合 在 一 起 而 设计 。 因此 ， 你 可 以 拥有 一 个 自 定义 颜色 的 样式 表 和 一 个 单 


独 的 样式 表 ， 用 于 更 改 演示 文档 的 元 率 大 小 。 这 些 样式 可 以 通过 传递 样式 列表 和 轻松 
组 合 : 


>>> import matplotlib.pyplot as plt 
>>> plt.style.use(['dark background', 'presentation']) 


请 注意 ， 右 侧 的 样式 将 履 盖 已 经 由 左 侧 样式 定义 的 值 。 


临时 样式 


如 果 只 想 对 特定 的 代码 块 使 用 样式 ， 但 不 想 更 改 全 局 样式 ， 那 么 样式 包 提供 了 一 个 
上 下 文 管理 器 ， 用 于 将 更 改 限制 于 特定 范围 。 要 隔离 你 的 样式 更 改 ， 你 可 以 编写 以 
TAX: 


>>> import numpy as np 
>>> import matplotlib.pyplot as plt 


>>> 

>>> with plt.style.context(('dark_background')): 

>>> plt.plot(np.sin(np.linspace(0, 2 * np.pi)), 'r-o') 
222 

>>> # Some plotting code with the default style 

222 


>>> plt.show() 


交互 式 给 


ERX BH 
交互 式 导航 
原文 : Interactive navigation 
译 者 : 飞龙 
协议 : CC BY-NC-SA 4.0 


4€540z 


所 有 图 形 窗口 都 带 有 导航 工具 栏 ， 可 用 于 浏览 数据 集 。 以 下 是 工具 栏 底 部 的 每 个 按 
钮 的 说 明 : 


» 


Home (XR) ^ Forward (前 进 ) 和 Back (后 退 ) 按钮 : 





这 些 类 似 于 Web 浏览 器 的 前 进 和 后 退 按钮 。 它 们 用 于 在 之 前 定义 的 视图 之 间 来 回 
"2 览 。 它们 没有 意义 ， 除 非 你 已 经 使 用 平移 和 缩放 按钮 访问 了 其 他 地 方 。 这 类 似 
尝试 在 访问 新 页 面 之 前 单 击 Web 浏览 器 上 的 返回 - 什么 都 不 会 发 生 。 首页 总 是 
Re 一 个 浏览 的 页 面 ， 以 及 你 的 数据 的 默认 视图 。 对 
于 Home ， Forward 和 Back ， 应 该 将 其 看 做 Web 浏 览 器 ， 其 中 的 数据 视图 是 
网 页 。 使 用 Pan 和 Zoom 来 定义 新 视图 。 


+ 


Pan/Zoom (平移 /缩放 ) 按钮 


此 按钮 有 两 种 模式 : 平移 和 缩放 。 单 击 工具 栏 按钮 激活 平移 和 缩放 ， 然 后 将 鼠标 放 
在 轴 域 的 某 个 地 方 。 按 住 鼠 标 左 键 并 将 其 拖 动 到 新 位 置 来 平移 图 形 。 当 你 释放 它 
时 ， 你 按 下 的 点 处 的 数据 将 移动 到 你 释放 的 点 。 如 果 在 平移 时 按 'x' AS) ty! s 
移动 会 分 别 限制 在 x A y 轴 。 按 和 鼠标 右键 并 将 其 拖 动 到 新 位 置 来 进行 缩放 。 向 
右 移 动 使 x 轴 成 比例 放大 ， 或 者 向 左 移动 成 比例 缩小 。 y 轴 和 上 /下 移动 同上 。 
开始 缩放 时 鼠标 下 的 点 会 保持 静止 ， 你 可 以 结交 图形 中 的 村 它 任意 点 。 你 可 以 使 用 
快捷 键 'x' > 'y' 或 CONTROL 分 别 将 缩放 约束 为 x hh y A UTR ELO m FS o 


D 图 时 ， 平 移 和 缩放 功能 的 和 ela o 可 以 使 用 鼠标 堪 键 拖 动 半 径 轴 标 
。 可 以 使 用 鼠标 右键 放大 和 缩小 3-2 à] 


Zoom-to-rectangle (缩放 到 和 矩形) 按钮 

单 击 此 工具 栏 按 钮 以 激活 此 模式 。 将 鼠标 放 在 轴 域 的 某 处 ， 然 后 按 和 鼠标 堪 键 。 在 
按 住 按钮 的 同时 拖 动 鼠标 到 新 位 置 并 释放 。 轴 域 会 放大 并 限制 于 你 定义 的 矩形 。 
在 此 模式 中 还 有 一 个 实验 性 的 zoom out to rectangle (H DIER) ， 使 用 右 
键 ， 将 整个 轴 域 缩小 并 放置 在 矩形 定义 的 区 域 中 。 
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使 用 此 工具 配置 子 图 的 参数 : 左边 距 ， 右 边 距 ， 上 边 距 ， 下 边 距 ， 行 间隔 和 列 间 


2 
陋 。 





= 
[E 


Save (tk) 44a 


单 击 此 按钮 可 局 动 文 件 保存 对 话 框 。 你 可 以 使 用 以 下 扩展 名 保存 文 
件 : png * ps ^ eps ， svg 和 pdf 。 


浏览 快捷 键 


下 表 包 含 所 有 默认 的 快捷 键 ， 可 以 使 用 matplotlibrc ( #keymap.* ) Rž ° 


命令 快捷 键 
主页 / 重 置 h ^ r X home 
后 退 c 、、 左 箭头 或 backspace 
8p 3t v XARA 
平移 /缩放 p 
缩放 到 和 矩形 0 
保存 ctrl + s 
切换 全 屏 SOUL «we qr 
关闭 绘图 ctrl + W 
将 平移 /缩放 限制 于 x d 使 用 鼠标 平移 /缩放 时 按 住 x 
将 平移 /缩放 限制 于 y d 使 用 鼠标 平移 /缩放 时 按 住 y 
T A E ry PG 使 用 鼠标 平移 /缩放 时 按 住 CONTROL 
切换 网 格 筷 标 在 轴 域 上 时 按 下 g 
切换 x 轴 刻 度 〈《 对 数 /线性 ) 鼠标 在 轴 域 上 时 按 下 上 或 上 k 
切换 y 轴 刻 度 (对 数 /线性 ) 筷 标 在 轴 域 上 时 按 下 1 


如 果 你 使 用 matplotlib.pyplot ， 则 会 为 每 个 图 形 自 动 创 建 工 具 栏 。 如 果 你 正 
在 编写 自己 的 用 户 界面 代码 ， 则 可 以 将 工具 栏 添加 为 窗口 小 部 件 。 确切 的 语法 取决 
于 你 的 Ul， 但 在 "matplotlib/examples/user interfaces 目 录 中 有 每 个 受 支持 的 UI 的 
示例 。 这 里 是 一 些 GTK 的 示例 代码 : 


import gtk 


from matplotlib.figure import Figure 

from matplotlib.backends.backend gtkagg import FigureCanvasGTKAg 
g as FigureCanvas 

from matplotlib.backends.backend gtkagg import NavigationToolbar 
2GTKAgg as NavigationToolbar 


win = gtk.Window() 

win.connect("destroy", lambda x: gtk.main quit()) 
win.set default size(400,300) 

win.set title("Embedding in GTK") 


vbox = gtk.VBox() 
win.add(vbox) 


fig = Figure(figsize=(5,4), dpi-100) 
ax = fig.add subplot(111) 
ax.plot([1,2,3]) 


canvas = FigureCanvas(fig) # a gtk.DrawingArea 
vbox.pack start(canvas) 

toolbar = NavigationToolbar(canvas, win) 
vbox.pack start(toolbar, False, False) 


win.show all() 
gtk.main() 


在 Python shell 中 使 用 Matplotlib 


原文 : Using matplotlib in a python shell 
译 者 : 飞龙 

协 仅 : CC BY-NC-SA 4.0 

孩 页 面 的 内 容 已 严重 过 时 。 


默认 情 况 下 > matplotlib 将 绘图 延迟 到 脚本 结 来 ， " 图 可 能 是 开销 大 的 操作 ， 
并 且 你 可 能 不 想 在 每 次 更 改革 个 属性 时 更 新 绘 而 是 只 在 所 有 属性 更 改 后 更 新 一 


次 。 


是 在 python shell 中 工作 时 ， 通 第 需要 用 每 个 命令 更 新 绘图 ， 例 如 ， 在 更 
^ xlabel() 或 一 行 的 标记 样式 之 后 。 虽然 这 在 概念 上 很 简单 ， 但 在 实践 中 它 可 
ARM > AA matplotlb 在 底层 是 一 个 图 形 用 户 界 面 应 用 程序 ， 并 拥有 一 些 技 
巧 ， 使 应 用 程序 在 一 个 python shell 正常 工作 。 


使 用 IPython 解决 


ERT EET tA US REN 

命名 空 会 影响 eoe 内 建设 施 ， 并 可 能 导致 错误 难以 跟踪 。 要 获得 
IPython 1 集成 而 无 需 导入 ， 使 用 %matplotlib 魔术 命令 是 首 个 选择 。 参见 
ipython X4% ° 


幸运 的 是 ， 一 个 增强 的 交互 式 python shell > ipython 已 经 找 出 了 所 有 这 些 技巧 ， 并 
且 可 被 matplotlib 感知 ， 所 以 当 你 在 pylab 模式 下 启动 ipython 。 


johnhQflag:-» ipython 

Python 2.4.5 (#4, Apr 12 2008, 09:09:16) 

IPython 0.9.0 -- An enhanced Interactive Python. 
In [1]: %pylab 


Welcome to pylab, a matplotlib-based Python environment. 
For more information, type 'help(pylab)'. 


In [2]: x = randn(10000) 


In [3]: hist(x, 100) 


它 为 你 设置 一 切 使 交互 式 绘图 工作 ， 就 像 你 期 望 的 那样 。 调 用 figure() 并 弹出 
图 形 窗 口 ， 调 用 plot() 使 你 的 数据 出 现在 图 形 窗口 中 。 


注意 在 上 面 的 例子 中 ， 我 们 没有 导入 任何 matplotlib 名 称 ， 因 为 在 pylab 模式 下 ， 
ipython 将 自动 导入 它们 。 ipython 还 为 你 启用 交互 模式 ， 这 会 导致 每 个 pyplot + 
令 触 发 图 形 更 新 ， 并 且 还 提供 了 一 个 matplotlib 感知 的 运行 命令 ， 来 高 效 运 行 
matplotlib 脚本 。 ipython 在 运行 命令 期 间 关 闭 交 互 模式 ， 然 后 在 运行 结束 时 恢复 交 
互 状态 ， 以 便 你 可 以 手动 继续 调整 图 形 。 


ipython 已 经 能 入 了 很 多 最 近 的 作品 ， 从 pylab 支持 ， 到 各 种 GUI 应 用 程序 ， 所 以 
请 检查 ipython 邮件 列表 的 最 新 状态 。 


其 它 Python 解释 器 


如 果 你 不 能 使 用 ipython， 并 且 仍 然 想 在 交互 式 python shell 使 用 
matplotlib/pylab， 例 如 ，plain-ole 标准 的 python 交互 式 解 释 蜂 ， 你 将 需要 了 解 什 
4 x matplotlib 后 端 ° 


有 了 TkAgg 后 端 ， 它 使 用 Tkinter 用 户 界 面 工 具 包 ， 你 可 以 从 任意 的 非 gui python 
shell 使 用 matplotlib 。 只 需 在 你 的 matplotlibrc 文件 中 设 

置 backend : TkAgg 和 interactive : True (请 参阅 目 定 义 matplotlib) 并 局 
动 python。 然后 : 


>>> from pylab import * 
>>> plot([i,2,3]) 
>>> xlabel('hi mom') 


应 该 能 够 开 箱 即 用 。 这 也 可 能 适用 于 最 新 版 本 的 qt4agg 和 gtkagg /& 39 * VA 
Macintosh 上 的 macosx 后 端 。 注意 ， 在 批 处 理 模式 下 ， 即 从 脚本 制作 图 形 时 ， 交 
互 模式 可 能 很 慢 ， 因 为 它 用 每 个 命令 重 绘图 形 。 因此 ， 你 可 能 需要 仔细 考虑 ， 然 后 
通过 matplotlibrc 文件 而 不 是 使 用 下 一 节 中 列 出 的 函数 ， 使 其 作为 默认 行为 。 


Gui shell 问题 最 多 ， 因 为 它们 必须 运行 主 循环 ， 但 是 交互 式 绘图 也 涉及 主 循环 。 
Ipython 已 经 为 matplotlib 主 后 端 解决 了 这 一 切 问 题 。 可 能 有 其 他 shell fe IDE 也 
可 以 在 交互 模式 下 使 用 matplotlib， 但 一 个 明显 的 候选 项 不 会 : python IDLE IDE X 
一 个 不 支持 pylab 交互 模式 的 Tkinter gui 应 用 程序 ， 无 论 后 端 是 什么 。 


控制 交互 式 更 新 


pyplot 接口 的 interactive 属性 控制 是 否 在 每 个 pyplot 命令 上 绘制 图 画 
布 。 如 果 interactive 是 False ， 那 么 每 个 plot 命令 都 会 更 新 图 形状 态 ， 但 
只 会 在 显 式 调用 draw() 时 绘制 。 当 interactive 为 True 时 ， 每 

个 pyplot 命令 都 会 触发 绘制 。 


pyplot 接口 提供 了 4 个 有 助 于 交互 式 控 制 的 命令 。 


isinteractive() 

返回 交互 式 设 置 。 True|False ° 

ion() 
将 交互 式 模式 打开 。 

ioff() 
将 交互 式 模式 关闭 。 

draw() 

强制 图 形 重 新 绘制 。 

当 处 理 绘图 开销 很 大 的 大 型 图 形 时 ， 你 可 能 希望 临时 关闭 matplotlib 的 交互 式 设置 
来 避免 性 能 损失 : 


>>> #create big-expensive-figure 

>>> ioff() # turn updates off 

>>> title('now how much would you pay? ) 

>>> xticklabels(fontsize=20, color='green' ) 

>>> draw() # force a draw 

>>> savefig('alldone', dpi=300) 

>>> close() 

>>> ion() # turn updating back on 

>>> plot(rand(20), mfc='g', mec-'r', ms-40, mew-4, ls-z'--', lw-z3 


事件 处 理 及 拾取 


原文 : Event handling and picking 
译 者 : 飞龙 
i : CC BY-NC-SA 4.0 


matplotlib 使 用 了 许多 用 户 界 面 工具 包 (wxpython > tkinter > qt4 > gtk 和 

macosx) ， 为 了 支持 交互 式 平移 和 缩放 图 形 等 功能 ， 拥 有 一 套 API 通过 按键 和 和 鼠 
标 移动 与 图 形 交 互 ， 并 且 『GUI 中 立 上 4， 对 开发 人 员 十 分 有 帮助 ， 所 以 我 们 不 必 重 
复 大 量 的 代码 来 跨 不 同 的 用 户 界 面 。 虽 然 事件 处 理 API 是 GUI 中 立 的 ， 但 它 是 基 
于 GTK 模型 ， 这 是 matplotlib 支持 的 第 一 个 用 户 界 面 。 与 标准 GUI 事件 相 比 ， 被 
触发 的 事件 也 比 matplotlib 丰富 一 些 ， 例 如 包括 发 生 事 件 

的 matplotlib.axes.Axes 的 信息 。 事 件 还 能 够 理解 matplotlib 坐标 系 ， 并 且 在 
事件 中 以 像素 和 数据 坐标 为 单位 报告 事件 位 置 。 


事件 连接 


要 接收 事件 ， 你 需要 编写 一 个 回调 函数 ， 然 后 将 你 的 函数 连接 到 事件 管理 器 ， 它 
是 FigureCanvasBase 的 一 部 分 。 这 是 一 个 简单 的 例子 ， 打 印 鼠 标点 击 的 位 置 和 
按 下 哪个 按钮 : 


fig = plt.figure() 
ax = fig.add_subplot(ii1) 
ax.plot(np.random.rand(i0) ) 


def onclick(event ) : 
print('button=%d, x=%d, y=%d, xdata=%f, ydata=%f' 96 
(event.button, event.x, event.y, event.xdata, event.yd 
ata) ) 
cid = fig.canvas.mpl connect('button press event', onclick) 


FigureCanvas 的 方法 mpl connect() 返回 一 个 连接 id ， 它 只 是 一 个 整数 。 
妆 你 要 断 开 回调 时 ， 只 需 调 用 : 


fig.canvas.mpl disconnect(cid) 


Eg 


画布 仅 保 留 回 调 的 弱 引 用 。 因此 ， 如 果 回 调 是 类 实例 的 方法 ， 你 需要 保留 对 访 
实例 的 引用 。 否则 实例 将 被 垃圾 回收 ， 回 调 将 消失 。 


尺 下 是 可 以 连接 到 的 事件 ， 在 事件 发 生 时 发 回 给 你 的 类 实例 以 及 事件 描述 : 


事件 名 称 
"button press event' 
"button release event' 
"draw event' 
"key press event' 
key release event' 
"motion notify event' 
pick event' 
resize event' 
"scroll event' 
"figure enter event' 
"figure leave event' 
axes enter event' 


'axes leave event' 


事件 属性 


所 有 matplotlib 事件 继承 自 基 类 matplotlib.backend bases.Event 


属性 : 

name 

事件 名 称 

canvas 

生成 事件 的 FigureCanvas 实例 
guiEvent 


触发 matplotlib 事件 的 GUI 事件 


最 常见 的 事件 是 按键 按 下 /释放 事件 、 鼠 标 按 下 /释放 和 移动 事件 。 处 理 这 些 事件 
的 KeyEvent 和 MouseEvent 类 都 派生 自 LocationEvent ， 它 具有 以 下 属性 : 


X 


X 位 置 ， 距 离 画布 左 端 的 像素 


类 和 描述 


MouseEvent - 鼠标 按钮 被 按 下 


\ 


MouseEvent - 鼠标 按钮 被 释放 
DrawEvent -画布 绘图 

KeyEvent - 按键 被 按 下 
KeyEvent - 按键 被 释放 
MouseEvent - 鼠标 移动 
PickEvent -画布 中 的 对 象 被 选中 
ResizeEvent -图 形 画 布 大 小 改变 


MouseEvent - 鼠标 滚轮 被 滚动 


LocationEvent - 鼠标 进入 新 的 图 形 
LocationEvent - 鼠标 离开 图 形 
LocationEvent - 鼠标 进入 新 的 轴 域 
LocationEvent - 鼠标 离开 轴 域 


> 储存 以 下 


y 
y 位 置 ， 距 离 画布 底 端 的 像素 

inaxes 
如 果 鼠 标 经 过 轴 域 ， 则 为 Axes 实例 

xdata 

筷 标 的 x 坐标 ， 以 数据 坐标 为 单位 

ydata 

鼠标 的 y 坐标 ， 以 数据 坐标 为 单位 
但 我 们 看 一 看 画布 的 简单 示例 ， 其 中 每 次 按 下 鼠标 时 都 会 创建 一 条 线段 。 


from matplotlib import pyplot as plt 


class LineBuilder: 
def — in (self, line): 
self.line - line 
self.xs - list(line.get xdata()) 
self.ys - list(line.get ydata()) 
self.cid - line.figure.canvas.mpl connect( button press 
event', self) 


def ill (self, event): 
print('click', event) 
if event.inaxes!=self.line.axes: return 
self.xs.append(event.xdata) 
self.ys.append(event.ydata) 
self.line.set data(self.xs, self.ys) 
self.line.figure.canvas.draw() 


PU = plt.figure() 

ax = fig.add subplot(111) 

ax.set -tie( click to build line SERO MESE ) 
line, = ax.plot([0], [0]) y ] 
linebuilder = LineBuilder(line) 


plt.show() 


我 们 刚刚 使 用 的 MouseEvent 证 一 个 LocationEvent ， 因 此 我 们 可 以 访 
l| event.x 和 event.xdata 中 的 数据 和 像素 坐标 。 除了 LocationEvent & 
性 ， 它 拥有 : 


button 


按 下 的 按钮 ， None ^ 1^2^3»^ 'up' ^ 'down' ( 'up' `œ 'down' HH TX 
动 事 件 ) 


key 


按 下 的 键 ， None ， 任 何 字 符 ， 'shift' ^ 'win' 或 者 'control' 


T 46,4 85 4E 70 25. 7] 


编写 使 用 Rectangle 实例 初始 化 的 可 拖 动 矩形 类 ， 但 在 拖 动 时 会 移动 

其 x c y 位 置 。 提 示 : 你 需要 存储 矩形 的 原始 xy b> BRA rect.xy 并 
连接 到 按 下 ， 和 移动 和 释放 鼠标 事件 。 当 鼠标 按 下 时 ， 检 查 点 击 是 否 发 生 在 你 的 矩形 
上 (JL matplotlib.patches.Rectangle.contains() ) » AJ» HH 

形 xy 和 数据 坐标 为 单位 的 鼠标 点 击 位 置 。 在 移动 事件 回调 中 ， 计 算 鼠 标 移动 

的 deltax 和 deltay ， 并 将 这 些 增 量 添加 到 存储 的 原始 矩形 ， 并 重新 绘图 。 在 
按钮 释放 事件 中 ， 只 需 将 所 有 你 存储 的 按钮 按 下 数据 重 置 为 None 。 


这 里 是 解决 方案 : 


import numpy as np 
import matplotlib.pyplot as plt 


class DraggableRectangle: 
def — init (self, rect): 
self.rect - rect 
self.press - None 


def connect(self): 

‘connect to all the events we need' 

self.cidpress = self.rect.figure.canvas.mpl connect( 
"button press event', self.on press) 

self.cidrelease = self.rect.figure.canvas.mpl connect( 
"button release event', self.on release) 

self.cidmotion = self.rect.figure.canvas.mpl connect( 
"motion notify event', self.on motion) 


def on press(self, event): 
‘on button press we will see if the mouse is over us and 
store some data' 
if event.inaxes !- self.rect.axes: return 


contains, attrd - self.rect.contains(event) 
if not contains: return 

print('event contains', self.rect.xy) 

x0, yO = self.rect.xy 

self.press = x0, yO, event.xdata, event.ydata 


def on motion(self, event): 
'on motion we will move the rect if the mouse is over us' 


if self.press is None: return 

if event.inaxes !- self.rect.axes: return 
x0, yO, xpress, ypress = self.press 

dx = event.xdata - xpress 


dy = event.ydata - ypress 

#print('x0=%f, xpress=%f, event.xdata=%f, dx=%f, x0+dx=% 
f' 96 

E (x0, xpress, event.xdata, dx, x0+dx) ) 

self.rect.set_x(x0+dx) 

self.rect.set y(yO-*dy) 


self.rect.figure.canvas.draw() 


def on release(self, event): 
On release we reset the press data' 
self.press - None 
self.rect.figure.canvas.draw() 


def disconnect(self): 
‘disconnect all the stored connection ids' 
self.rect.figure.canvas.mpl disconnect(self.cidpress) 
self.rect.figure.canvas.mpl disconnect(self.cidrelease) 
self.rect.figure.canvas.mpl disconnect(self.cidmotion) 


fig - plt.figure() 
ax = fig.add subplot(111) 
rects = ax.bar(range(i0), 20*np.random.rand(i0)) 
drs = [] 
for rect in rects: 
dr = DraggableRectangle(rect ) 
dr.connect() 
drs.append(dr) 


plt.show() 
Eee 

















附加 题 : 使 用 动画 秘籍 中 讨论 的 动画 blit 技术 ， 使 动画 绘制 更 快 更 流畅 。 
附加 题解 决 方案 : 


# draggable rectangle with the animation blit techniques; see 
# http://www.scipy.org/Cookbook/Matplotlib/Animations 

import numpy as np 

import matplotlib.pyplot as plt 


class DraggableRectangle: 
lock = None # only one can be animated at a time 
def — init (self, rect): 
self.rect - rect 
self.press - None 
self.background = None 


def connect(self): 
'connect to all the events we need' 
self.cidpress = self.rect.figure.canvas.mpl connect( 


"button press event', self.on press) 
self.cidrelease = self.rect.figure.canvas.mpl connect( 
"button release event', self.on release) 
self.cidmotion = self.rect.figure.canvas.mpl connect( 
"motion notify event', self.on motion) 


def on press(self, event): 
‘on button press we will see if the mouse is over us and 
store some data' 
if event.inaxes !- self.rect.axes: return 
if DraggableRectangle.lock is not None: return 
contains, attrd - self.rect.contains(event) 
if not contains: return 
print('event contains', self.rect.xy) 
x0, yO = self.rect.xy 
self.press = x0, yO, event.xdata, event.ydata 
DraggableRectangle.lock - self 


# draw everything but the selected rectangle and store t 
he pixel buffer 

canvas = self.rect.figure.canvas 

axes - self.rect.axes 

self.rect.set animated(True) 

canvas.draw( ) 

self.background = canvas.copy from bbox(self.rect.axes.b 
box) 


4 now redraw just the rectangle 
axes.draw artist(self.rect) 


# and blit just the redrawn area 
canvas.blit(axes.bbox) 


def on motion(self, event): 
'on motion we will move the rect if the mouse is over us' 


if DraggableRectangle.lock is not self: 
return 

if event.inaxes !- self.rect.axes: return 

x0, yO, xpress, ypress = self.press 

event.xdata - xpress 

dy = event.ydata - ypress 

self.rect.set_x(x0+dx) 

self.rect.set_y(y0+dy ) 


Q 
X 
II 


canvas = self.rect.figure.canvas 

axes = self.rect.axes 

# restore the background region 
canvas.restore_region(self.background) 


# redraw just the current rectangle 
axes.draw_artist(self.rect) 


# blit just the redrawn area 
canvas.blit(axes.bbox) 


def on release(self, event): 
'on release we reset the press data' 
if DraggableRectangle.lock is not self: 
return 


self.press = None 
DraggableRectangle.lock - None 


# turn off the rect animation property and reset the bac 
kground 

self.rect.set_animated(False) 

self.background = None 


# redraw the full figure 
self.rect.figure.canvas.draw() 


def disconnect(self): 
"disconnect all the stored connection ids' 
self.rect.figure.canvas.mpl disconnect(self.cidpress) 
self.rect.figure.canvas.mpl disconnect(self.cidrelease) 
self.rect.figure.canvas.mpl disconnect(self.cidmotion) 


fig - plt.figure() 
ax = fig.add subplot(111) 
rects = ax.bar(range(i0), 20*np.random.rand(i0) ) 
drs = [] 
for rect in rects: 
dr = DraggableRectangle(rect ) 
dr.connect() 
drs.append(dr) 


plt.show() 
a] ecce Hoi 


鼠标 进入 和 离开 


如 果 和 希望 在 和 鼠标 进入 或 离开 图 形 时 通知 你 ， 你 可 以 连接 到 图 形 / 轴 域 进入 /离开 事 
件 。 下面 是 一 个 简单 的 例子 ， 它 改变 了 和 鼠标 所 在 的 轴 域 和 图 形 的 背景 颜色 : 


Illustrate the figure and axes enter and leave events by changin 
g the 
frame colors on enter and leave 


import matplotlib.pyplot as plt 


def enter axes(event): 
print('enter axes', event.inaxes) 
event.inaxes.patch.set facecolor('yellow') 
event.canvas.draw() 


def leave axes(event): 
print('leave axes', event.inaxes) 
event.inaxes.patch.set facecolor('white') 
event.canvas.draw() 


def enter figure(event): 
print('enter figure', event.canvas.figure) 
event.canvas.figure.patch.set facecolor(' red ) 
event.canvas.draw() 


def leave figure(event): 
print('leave figure', event.canvas.figure) 
event.canvas.figure.patch.set facecolor( 'grey') 
event.canvas.draw() 


figi = plt.figure() 

figi.suptitle('mouse hover over figure or axes to trigger events' 
) 

axi figi.add subplot(211) 

ax2 = figi.add_subplot( 212) 


figi.canvas.mpl connect('figure enter event', enter figure) 
figi.canvas.mpl connect('figure leave event', leave figure) 
figi.canvas.mpl connect('axes enter event', enter axes) 
figi.canvas.mpl connect('axes leave event', leave axes) 


fig2 = plt.figure() 

fig2.suptitle('mouse hover over figure or axes to trigger events' 
) 

axi fig2.add subplot(211) 

ax2 - fig2.add subplot(212) 


fig2.canvas.mpl connect('figure enter event', enter figure) 
fig2.canvas.mpl connect('figure leave event', leave figure) 
fig2.canvas.mpl connect('axes enter event', enter axes) 
fig2.canvas.mpl connect('axes leave event', leave axes) 


plt.show() 





IT RAS HL 

你 可 以 通过 设置 艺术 家 的 picker 属性 (例如 ，matplotlib 

Line2D * Text * Patch * Polygon ， AxesImage +) 来 启用 选择 ， 
picker 属性 有 多 种 含义 : 

None 

选择 对 于 该 艺术 家 已 禁用 (上 默认) 

boolean 

如 果 为 True ， 则 启用 选择 ， 当 鼠标 移动 到 该 艺术 家 上 上方 时 ， 会 触发 事件 
float 


如 果 选 择 器 是 数字 ， 则 将 其 解释 为 点 的 8 公差 ， 并 且 如 果 其 数据 在 鼠标 事件 的 8 
内 ， 则 艺术 家 将 触发 事件 。 对 于 像 线 条 和 补丁 集合 的 一 些 艺术 家 ， 艺 术 家 可 以 向 生 
成 的 选择 事件 提供 附加 数据 ， 例 如 ， 在 选择 事件 的 e 内 的 数据 的 索引 。 


如 果 拾 取 器 是 可 调用 的 ， 则 它 是 用 户 提 供 的 函数 ， 用 于 确定 艺术 家 是 否 被 鼠标 事件 
击 中 。 签名 为 hit，props = picker(artist, mouseevent) ， 用 于 测试 是 否 命 
Po hR REFE RRE?’ AE hit = True > props 是 一 个 属性 字典 ， 
它们 会 添加 到 PickEvent 属性 。 


通过 设置 picker 属性 启用 对 艺术 家 进行 拾取 后 ， 你 需要 连接 到 图 画布 
的 pick event ， 以 便 在 鼠标 按 下 事件 中 获取 拾取 回调 。 例 如 : 


def pi andler(event): 
mouseevent - event.mouseevent 
artist - event.artist 


传 给 你 的 回调 的 PickEvent 事件 永远 有 两 个 属性 : 

mouseevent 

是 生成 拾取 事件 的 鼠标 事件 。 鼠 标 事 件 具 有 像 x 和 y (显示 空间 中 的 坐标 ， 例 
wW o EAZ’ THRA) 和 xdata > ydata (数据 空间 中 的 坐标 ) 的 属性 。 此 


外 ， 你 可 以 获取 有 关 按 下 哪些 按钮 ， 按 下 哪些 键 ， 鼠 标 在 哪个 轴 域 上 面 等 信息 。 庄 
细 信 息 请 参阅 matplotlib.backend bases.MouseEvent ° 


artist 
生成 拾取 事件 的 Artist 。 


另外 ， 像 Line2D 和 PatchCollection 的 某 些 艺术 家 可 以 将 附加 的 元 数据 (eR 
2]) 附加 到 满足 选择 器 标准 的 数据 中 (例如 ， 行 中 在 指定 8 容 差 内 的 所 有 点 ) 


简单 拾取 示例 


在 下 面 的 示例 中 ， 我 们 将 行 选择 器 属性 设置 为 标量 ， 因 此 它 表 示 以 点 为 单位 的 容 差 
(72 K/T) o 当 拾 取 事 件 位 于 距离 线条 的 容 差 范围 时 ， 将 调用 onpick UT 
数 ， 并 且 带 有 在 拾取 距离 容 差 内 的 数据 顶点 索引 。 我们 的 onpick 回调 函数 只 打 
印 在 拾取 位 置 上 的 数据 。 不 同 的 matplotlib 艺术 家 可 以 将 不 同 的 数据 附加 

到 PickEvent 。 例如 ， Line2D 将 ind 属性 作为 索引 附加 到 拾取 点 下 面 的 行 数 
据 中 。 有 关 Line 的 PickEvent 属性 的 详细 信息 ， 请 参阅 pick() 。 这 里 是 代 
码 : 


import numpy as np 
import matplotlib.pyplot as plt 


fig - plt.figure() 
ax = fig.add subplot(111) 
ax.set title('click on points') 


line, = ax.plot(np.random.rand(i00), 'o', picker=5) 


def onpick(event): 
thisline = event.artist 
xdata = thisline.get xdata() 
ydata = thisline.get ydata() 
ind = event.ind 
points = tuple(zip(xdata[ind], ydata[ind])) 
print('onpick points:', points) 


fig.canvas.mpl connect('pick event', onpick) 


plt.show() 


拾取 练习 


创建 含有 100 个 数组 的 数据 集 ， 包 人 钨 1000 个 高 斯 随机 数 ， 并 计算 每 个 数组 的 样本 
平均 值 和 标准 差 (提示 : numpy 数组 具有 mean 和 std AH) ， 并 制作 100 个 
均值 与 100 个 标准 的 xy 标记 图 。 将 绘图 命令 创建 的 线条 连接 到 拾取 事件 ， 并 绘 
制 数据 的 原始 时 间 序 列 ， 这 些 数据 生成 了 被 点 击 的 点 。 如 果 在 被 点 击 的 点 的 容 差 范 
内 存在 多 于 一 个 点 ， 则 可 以 使 用 多 个 子 图 来 绘制 多 个 时 间 厚 列 。 


练习 的 解决 方案 : 


compute the mean and stddev of 100 data sets and plot mean vs st 
ien vum click on one of the mu, sigma points, plot the raw data 
the dataset that generated the mean and stddev 

import numpy as np 

import matplotlib.pyplot as plt 


X = np.random.rand(i00, 1000) 
xs = np.mean(X, axis=1) 

ys = np.std(X, axis-i) 

fig = plt.figure() 

ax = fig.add subplot(111) 

ax.set title('click on point to plot time series') 

line, = ax.plot(xs, ys, 'o', picker-5) # 5 points tolerance 


def onpick(event): 
if event.artist!-line: return True 


N - len(event.ind) 
if not N: return True 


figi = plt.figure() 
for subplotnum, dataind in enumerate(event.ind): 
ax = figi.add_subplot(N, 1, subplotnum+? ) 
ax.plot(X[dataind]) 
ax.text(0.05, 0.9, ‘mu=%1.3f\nsigma=%1.3f'%(xs[dataind], 
ys[dataind]), 
transform=ax.transAxes, va='top' ) 
ax.set_ylim(-0.5, 1.5) 
figi.show() 
return True 


fig.canvas.mpl connect('pick event', onpick) 


plt.show() 


所 选 示例 


屏幕 截图 
原文 : Screenshots 
译 者 : 飞龙 
tit : CC BY-NC-SA 4.0 
这 里 你 会 找到 一 些 示例 图 和 生成 它们 的 代码 。 


简单 绘 
这 里 是 一 个 带 有 文本 标签 的 基本 的 绘图 : 
源 代码 


About as simple as it gets, folks 


- m M 
in c 
O u = 


) 
F 
BJ 
Un 


voltage (mV 





0.00 025 0.50 0.75 100 125 1.50 1.75 2.00 
time (s) 


子 图 示例 


多 个 轴 域 〈 例 如 子 图 ) 可 使 用 subplot() 命令 创建 : 
源 代码 


A tale of 2 subplots 


Damped oscillation 
oo 
e 


Undamped 
lu 
e 


0.00 025 0.50 0.75 100 125 150 1.75 2.00 
time (s) 


直方 图 
hist() 命令 自动 生成 直方 图 ， 并 返回 项 数 或 者 概率 : 
We. AG 


屏幕 截图 


Histogram of IQ: u = 100,0= 15 


0.030 


0.0725 


0.020 


0.015 


Probability density 


0.010 


0.005 





0.000 
60 70 80 90 100 110 120 130 


路 径 示 倒 
你 可 以 使 用 matplotlib.path 模块 ， 在 maplotlib 中 添加 任意 路 径 : 


源 代 码 


199 
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mplot3d 

mplot3d LÆ &, ( X, mplot3d 教程 和 mplot3d 示例 ) 支持 简单 的 三 维 图 形 ， 包 括 平 
人 台 、 线 框图 、 散 点 图 和 条 形 图 。 

源 代码 
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感谢 John Porter > Jonathan Taylor > Reinier Heeres 和 Ben Root 开发 了 mplot3d 
工具 包 。 此 工具 包 和 包含 于 所 有 标准 matplotlib 安装 中 。 


Streamplot 


streamplot() 远 数 绘制 向 量 场 的 流 线 图 。 除 了 简单 地 绘制 流 线 之 外 ， 它 还 允许 
将 流 线 的 凑 色 和 /或 线 宽 映 射 到 单独 的 和 参数， 例如 向 量 场 的 速度 或 局 部 密度 。 


源 代码 





这 个 特性 完善 了 绘制 向 量 场 的 quiver() Bae 感谢 Tom Flanagan 和 Tony You 
添加 streamplot Hz ° 


FF A, B 


Di 


为 了 支持 Phoenix Mars Mission (使 用 matplotlib 展示 地 面 跟 踪 的 航天 器 ) ， 
Michael Droettboom 在 Charlie Moad 的 工作 基础 上 提供 了 非常 精确 的 椭圆 缴 的 8- 
样 条 近似 ( 见 Arc ) ， 它 对 缩放 级 别 并 不 敏感 。 


源 代码 





条 形 图 
使 用 bar() 命令 创建 条 形 图 十 分 容易 ， 其 中 包括 一 些 定 制 〈《 如 误差 条 ) 


源 代 码 
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LE EMG 


Scores by group and gender 


35 

















E 
Group 


$|:23E 4 & ( bar stacked.py ) *» R #& ( finance demo.py ) 和 水 平 条 形 
A ( barh demo.py ) 也 很 简单 。 


tt A 

pie() TEARRE co 可 选 功能 包括 自动 标记 区 域 的 百分比 ， 从 人 饼 图 
中 心 向 外 生成 一 个 或 多 个 模 形 以 及 阴影 效果 。 仔细 查看 附加 的 代码 ， 它 用 几 行 代码 
来 生成 这 个 图 像 。 

源 代码 
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Hogs 





Rainy 





Sunny Cloudy 


表格 示例 


table() 命令 向 轴 域 添加 文本 表格 。 
源 代码 
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Loss by Disaster 
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散 点 图 示例 


scatter() 命令 使 用 (可 选 的 ) 大 小 和 颜色 参数 创建 散 点 图 。 此 示例 描绘 
Google 股票 价格 的 变化 ， 标 记 的 尺寸 反映 了 交易 量 ， 并 且 闫 色 随 时 间 变 化 。 这 
里 ，ALPHA 属性 用 于 制作 半 透 明 圆 形 标记 。 


源 代 码 


NAC 
200 
Ga NS NI 


J Ae AA B 


Volume and percent change 
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0.15 
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iH AR TR Bl 
Matplotlib 拥有 基本 的 GUI 小 部 件 ， 它 们 独立 于 您 正在 使 用 的 图 形 用 户 界面 ， 允 许 
您 编写 GUI 交叉 图 形 和 小 部 件 。 请 参阅 matplotlib.widgets 和 小 部 件 示例 。 
源 代码 
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Amp EEEEEENEEEEN 5.00 
req NN  — — 3 A-A: 


十 元 示例 
fill() 命令 可 以 绘制 填充 曲线 和 多 边 形 : 


源 代 码 


LE EMG 





感谢 Andrew Straw 添加 了 这 个 函数 。 


日 期 示例 


你 可 以 绘制 日 期 数据 与 主要 和 次 要 刻度 ， 以 及 用 于 二 者 的 自 定义 刻度 格式 化 器 。 
源 代码 
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详细 信息 和 用 法 请 参阅 matplotlib.ticker 和 matplotlib.dates ° 


金融 图 表 


您 可 以 通过 结合 matplotlib 提供 的 各 种 绘图 函数 ， 布 局 命令 和 标签 工具 来 创建 复杂 
的 金融 图 表 。 以 下 示例 模拟 ChartDirector 中 的 一 个 财务 图 : 


源 代 码 


«30 = oversold 


. 19-Dec-2016 0:226.01 H-226.08 L:224.67 C-225.p4, 





NS) o9? 4o? 49» MU aor" 49v? 49v" 49v? 49v? 


地 图 示例 


Jeff Whitaker 的 Basemap 附加 工具 包 可 以 在 许多 不 同 的 地 图 投影 上 绘制 数据 。 此 
示例 展示 了 如 何在 直角 投影 上 绘制 轮廓 ， 标 记 和 文本 ， 以 NASA 的 “ 蓝 色 大 理 石 " 卫 
星 图 像 作为 背景 。 


源 代 码 
对 数 绘图 


semilogx() ， semilogy() 和 loglog() 函数 简化 了 对 数 绘图 的 创建 。 
源 代 码 


semilogy semilogx 
107 + | | eri 






1071 





0 10 20 10-2 1071 10° 10! 
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6x 10" 


4 x 10? 
3 x 10 


10! 10° 


极 轴 绘图 


polar() 命令 生成 极 轴 绘 图 。 
源 代码 


A line plot on a polar axis 
90° 





270° 


图 例 


legend() 命令 使 用 MATLAB 兼容 的 图 例 布 局 命令 自动 生成 图 形 图 例 。 
源 代 码 





感谢 Charles Twardy 编写 了 图 例 命 令 的 输入 。 


数学 公式 示例 


下 面 是 matplotlib 内 部 数学 公式 引擎 现在 支持 的 许多 TeX RIA AW KH] © 
mathtext 模块 使 用 freetype2 和 BaKoMa 或 STIX 现代 字体 提供 TeX 风格 的 数 
学 表达 式 。 其 他 详细 信息 请 参阅 matplotlib.mathtext 模块 。 


源 代码 


Matplotlib's math rendering i i 


1 | 
W338 = UF ^ da’, 一 GU lo, | 
010102 api T 8n2 |. QUoB | . 


p102 
susscripE s and superscripts: 


a; 7 Bj, a1, 4 — sin(2nf;it))e ?*7, 


Fractions, binomials and stacked numbers: 


LOAN. 


Radicals: 


v2, Vx, 


Fonts: 
Roman, /talic , Typewriter or CALLIGRAPHY 


Accents: 


, à, à, a, XYZ, XYZ, 
Greek, Hebrew: 


a, B. x, 6, A, u, A, T, Q, ©, N, Y, VN, 2, 4, 1, 


Delimiters, functions and Symbols: 


LL f. 6. [1 >, log, sin, =, 6, *, «, o, a, 9, 


Matplotlib 的 mathtext 基础 结构 是 一 个 独立 的 实现 ， 不 需要 TeX 或 计算 机 上 安装 
的 任何 外 部 软件 包 。 请 参阅 编写 数学 表达 式 教程 。 





TeX JR Ava AE 


虽然 matplotlib 的 内 部 数学 泻 染 引 擎 相当 强大 ， 但 有 时 你 还 是 需要 TeX © Matplotlib 
支持 带 有 usetex 选项 的 TeX 外 部 字符 串 泻 染 。 


源 代码 


TEX is Number 》 | 


n=l 





voltage (mV) 





0.0 0.2 0.4 0.6 0.3 1.0 


time (s) 


EEG 示例 


您 可 以 将 matplotlib # AZ) pygtk > wx’ Tk» FLTK 或 Qt 应 用 程序 中 。 这 是 一 个 名 
为 pbrain 的 EEG 查看 器 的 屏幕 截图 。 


* EEG Viewer and Analyzer 
File Patients View Compute 


—_ a a z 


= = 
Ea 


n i! 


I4 4 5» 5I Ga Yve sug 


Message: Electrode: RTG12 





下 轴 使 用 specgram() 绘制 其 中 一 个 EEG 通道 的 频谱 图 。 


有 关 将 matplotlib RA RALA 6, 84 RH > HA: 


user interfaces 示例 代码 
user interfaces 示例 代码 : embedding in wx2.py 


| embedding_in_gtk2.py 
| 

user interfaces 示例 代码 : mpl with glade.py 
| 
| 


— 


user interfaces 示例 代码 : embedding in qt4.py 
user interfaces 示例 代码 : embedding in tk.py 


XKCD 风格 的 于 绘图 


matplotlib 支持 xkcd 风格 的 绘图 。 
源 代码 
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THE DAY | REALIZED 
| COULD COOK BACON 
WHENEVER | WANTED 


MY OVERALL HEALTH 





TIME 
STOVE OWNERSHIP" FROM XKCD BY RANDALL MONROE 


CLAIMS OF SUPERNATURAL POWERS 





i | NI 
CONFIRMED BY REFUTED BY 
EXPERIMENT EXPERIMENT 
"THE DATA SO FAR" FROM XKCD BY RANDALL MONROE 


我 们 最 喜欢 的 秘籍 


原文 : Our Favorite Recipes 

译 者 : 飞龙 

WU: CC BY-NC-SA 4.0 
这 里 是 一 个 简短 的 教程 ， 示 例 和 代码 片段 的 集合 ， 展 示 了 一 些 有 用 的 经 验 和 技巧 ， 
来 制作 更 精美 的 图 像 ， 并 克服 一 些 matplotlib 的 缺陷 。 
FL th IR Hl Fe AL A 
通 第 用 于 使 两 个 或 更 多 绘图 共享 一 个 轴 ， 例 如 ， 两 个 子 绘图 具有 时 间作 为 公共 轴 。 
当 你 平移 和 缩放 一 个 绘图 ， 你 想 让 另 一 个 绘图 一 起 移动 。 为 了 方便 这 一 点 ， 
matplotlib 轴 支 持 sharex 和 sharey 属性 。 创建 subplot() 或 axes() 实例 
时 ， 你 可 以 传 入 一 个 关键 字 ， 表 明 要 共 译 的 轴 。 

In [96]: t = np.arange(0, 10, 0.01) 

In [97]: ax4 = plt.subplot(211) 


In [98]: axi.plot(t, np.sin(2*np.pi*t)) 
Out[98]: [<matplotlib.lines.Line2D object at 0x98719ec»] 


In [99]: ax2 = plt.subplot(212, sharex=ax1) 


In [166]: ax2.plot(t, np.sin(4*np.pi*t)) 
Out[100]: [«matplotlib.lines.Line2D object at Oxb/d8fec>] 


轻松 创建 子 图 


在 matplotlib 的 早期 版 本 中 ， 如 果 你 想 使 用 pythonic API 并 创建 一 个 figure X 
例 ， 并 从 中 创建 一 个 subplots 网 格 ， 而 且 可 能 带 有 共享 轴 ， 它 涉及 大 量 的 样板 代 
Ao 例如 : 


fig = plt.figure() 


ax1 = fig.add subplot(221) 

ax2 = fig.add subplot(222, sharex-axí1, sharey=ax1) 
ax3 = fig.add subplot(223, sharex=ax1, sharey=ax1) 
ax3 = fig.add subplot(224, sharex=ax1, sharey=ax1) 


Fernando Perez 提供 了 一 个 很 好 的 顶级 方法 ， 来 一 次 性 创建 subplots() (注意 
末尾 的 s) ， 并 为 所 有 子 图 开局 x 和 y 共享 。 你 可 以 单独 解构 来 获取 轴 域 : 


T aye Cc ti ] C neat lc AN A u [ NANA A | / 全 |~ (C AVA C 
# new style method 1; unpack the axes 


fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2, sharex=True, 
sharey=True) 
ax1.plot(x) 


KAIF CINE A AT RAY ARAA > x d$ numpy *5l: 





LL A (7 1 一 om j 了 an nT F lL, m Al A a | or 43 v^ ANSA C £X vy ym eV 
F new style method z, use an axes array 


fig, axs = plt.subplots(2, 2, sharex=True, sharey-True) 
axs[0,0].plot(x) 


修复 第 见 的 日 期 问题 


matplotlib 允许 你 本 地 绘制 python datetime 实例 ， 并 且 在 大 多 数 情况 下 ， 可 以 很 好 
地 挑选 刻度 位 置 和 字符 串 格 式 。 但 有 几 件 事情 它 不 能 妥善 处 理 ， 这 里 有 一 些 技 巧 ， 
用 于 帮助 你 解决 他 们 。 我 们 将 在 numpy 记录 数组 中 加 载 一 些 包 

& datetime.date 对 象 的 示例 日 期 数据 : 


In [63]: datafile = cbook.get sample data('goog.npy') 
In [64]: r = np.load(datafile).view(np.recarray ) 


In [65]: r.dtype 

Out[65]: dtype([('date', '|04'), ('', '|V4'), ('open', '«f8'), 
('high', '«f8'), ('low', '«f8'), ('close', '«f8' 

); 


('volume', '«i8'), ('adj close', '«f8')]) 


In [66]: r.date 
Out[66]: 
array([2004-08-19, 2004-08-20, 2004-08-23, ..., 2008-10-10, 2008 
Saale) 
2008-10-14], dtype=object ) 


字段 日 期 的 numpy 记录 数组 的 dtype = | 04 ， 这 意味 着 它 是 一 个 4 字 节 的 
python 对 象 指针 ; 在 这 种 情况 下 ， 对 象 是 datetime.date 实例 ， 当 我 们 在 ipython 
终端 窗口 中 打印 一 些 样 本 时 ， 我 们 可 以 看 到 。 


如 果 你 绘制 数据 ， 


In [67]: plot(r.date, r.close) 
Out[67]: [<matplotlib.lines.Line2D object at 0x92a6b6c»] 


你 会 看 到 x 轴 标 俭 重 合 到 一 起 。 


Default date handling can cause overlapping labels 
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3j — A ith XR o de IRE Ree ROL? HE x fe y 坐标 处 查看 matplotlib 工 
具 栏 (交互 式 导 航 ) 的 右 下 角 ， 你 会 看 到 X 位 置 的 格式 与 刻度 标签 的 格式 相同 ， 例 
如 ，『Dec20044 ° 我 们 想 要 的 是 工具 栏 中 的 位 置 具有 更 高 的 精确 度 ， 例 如 ， 鼠 
标 巧 停 在 上 面 时 给 我 们 确切 的 日 期 。 为 了 解决 第 一 个 问题 ， 我 们 可 以 使 

用 matplotlib.figure.Figure.autofmt xdate() 。 修 复 第 二 个 问题 ， 我 们 可 以 
使 用 ax.fmt xdata 属性 ， 该 属性 可 以 设置 为 任何 接受 标量 并 返回 字符 串 的 函 

数 。 matplotlib 有 一 些 内 置 的 日 期 格式 化 器 ， 所 以 我 们 将 使 用 其 中 的 一 个 。 


plt.close('all') 
fig, ax = plt.subplots(1) 
ax.plot(r.date, r.close) 


# rotate and align the tick labels so they look better 
fig.autofmt xdate() 


4 use a more precise date string for the x axis locations in the 
# toolbar 

import matplotlib.dates as mdates 

ax.fmt xdata = mdates.DateFormatter( '%Y-%m-%d' ) 
plt.title('fig.autofmt xdate fixes the labels') 


fig.autofmt xdate fixes the labels 
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现在 ， 当 你 将 和 鼠标 悬 停 在 绘制 的 数据 上 ， 你 将 在 工具 栏 中 看 到 如 2004-12-01 的 
日 期 格式 字符 串 。 


RAR A 


fill between() 函数 在 所 小 和 了 大 边界 之 间 生 成 阴影 区 域 ， 用 于 展示 范围 。 € 
有 一 个 非 第 方便 的 参数 ， 将 需 充 范围 与 逻辑 范围 组 合 ， 人 例如， 以便 仅 击 充 超 过 东 个 
i] 4& a Wy 2X, o = 


基本 上 ， fill between 可 以 用 来 增强 图 形 的 视觉 外 观 。 让 我 们 比较 两 个 财务 -时 
间 图 表 ， 左 边 是 一 个 简单 的 线 框图 ， 右 边 是 一 个 填充 图 。 
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Alpha 通道 在 这 里 不 是 必需 的 ， 但 它 可 以 用 来 软化 颜色 ， 创 建 更 具 视 觉 吸引 力 的 绘 
图 。 在 其 他 示例 中 ， 我 们 将 在 下 面 看 到 ，Alpha 通道 在 功能 上 有 用 ， 因 为 阴影 区 域 
"TY *4:»Alpha 允许 你 同时 看 到 两 者 。 注意 ，postscript 格式 不 支持 alpha (这 是 
一 个 postscript 限制 ， 而 不 坪 一 个 matplotlib 限制 ) ， 因 此 ， 当 使 用 alpha 时 ， 将 
你 的 数字 保存 在 PNG，PDF 或 SVG 中 。 


我 们 的 下 一 个 例子 是 计算 随机 漫步 的 两 个 群体 ， 它 们 具有 不 同 的 正 态 分 布 平 均值 和 
标准 差 ， 足 迹 会 从 中 绘制 。 我 们 使 用 共享 区 域 来 绘制 群体 的 平均 位 置 的 加 / 减 一 个 标 
准 差 。 这 里 的 Alpha 通道 是 有 用 的 ， 不 只 是 为 了 审美 。 


NO 
NO 


import matplotlib.pyplot as plt 
import numpy as np 


Nsteps, Nwalkers - 100, 250 
t - np.arange(Nsteps) 


# an (Nsteps x Nwalkers) array of random walk steps 
S1 = 0.002 + 0.01*np.random.randn(Nsteps, Nwalkers) 
S2 = 0.004 + 0.02*np.random.randn(Nsteps, Nwalkers) 


# an (Nsteps x Nwalkers) array of random walker positions 
X1 = $1.cumsum(axis=0 ) 
X2 = S2.cumsum(axis-) 


# Nsteps length arrays empirical means and standard deviations o 
f both 

4 populations over time 

mul = Xi.mean(axis-i) 

sigmad = X1.std(axis-i) 

mu2 = X2.mean(axis-i) 

sigma2 = X2.std(axis-i) 


# plot it! 

fig, ax = plt.subplots(1) 

ax.plot(t, mui, lw-2, label-'mean population 1', color='blue' ) 
ax.plot(t, mu2, lw-2, label-'mean population 2', color='yellow' ) 
ax.fill between(t, mui+sigmai1, mui1-sigmai, facecolor='blue', alp 
ha=0.5) 

ax.fill_between(t, mu2+sigma2, mu2-sigma2, facecolor='yellow', a 
lpha=0.5) 

ax.set title('random walkers empirical $\mu$ and $\pm \sigma$ in 
terval' ) 

ax.legend(loc='upper left' ) 

ax.set xlabel('num steps' ) 

ax.set ylabel('position') 

ax.grid() 


我 们 最 喜欢 的 秘籍 
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where 关键 字 参 数 非常 方便 地 用 于 突出 显示 图 形 的 茶 些 区 域 。 其 中 使 用 

与 x * ymin 和 ymax 参数 相同 长 度 的 布尔 掩 码 ， 并 且 只 UO Rar dea 

A True 的 区 域 。 在 下 面 的 例子 中 ， 我 们 模拟 一 个 随机 漫步 者 ， 并 计算 人 口 位 置 
的 分 析 平 均值 和 标准 差 。 群体 平均 值 显示 为 黑色 虚线 ， 并 且 平 均值 的 加 / 减 一 个 标 
准 差 显示 为 黄色 填充 区 域 。 我 们 使 用 where=X>upper_bound 找到 漫步 者 在 一 个 
标准 差 边界 之 上 的 区 域 ， 并 将 该 区 域 变 成 蓝 色 。 
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有 时 你 在 绘制 数据 之 前 就 知道 你 的 数据 是 什么 样 的 ， 并 且 可 能 知道 例如 右上 角 没 有 


太 多 数据 。 然 后 ， 你 可 以 安全 地 创建 不 覆盖 你 的 数据 的 图 例 : 


ax.legend(loc-'upper right') 


其 他 时 候 你 不 知道 你 的 数据 在 哪里 ， 而 loc z'best' 将 尝试 和 放置 图 例 : 


ax.legend(loc='best' ) 
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np.random.seed(1234) 
fig, ax = plt.subplots(1) 


不 


ax.plot(np.random.randn(300), 'o-', label-'normal distribution') 
ax.plot(np.random.rand(300), 's-', label-'uniform distribution ') 


ax.set ylim(-3, 3) 
ax.legend(loc='best', fancybox=True, framealpha=0.5) 


ax.set title('fancy, transparent legends' ) 


N 
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我 们 最 喜欢 的 秘籍 
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时 文本 框 


当 使 用 文本 框 装饰 轴 时 ， 两 个 有 用 的 技巧 是 将 文本 放置 在 轴 域 坐标 中 (请 参见 变换 
RE a apri Le deep ia adi 你 还 可 以 使 用 文本 

的 bbox 属性 ， 用 Patch 实例 包围 文本 - bbox 关键 字 参 数 接 受 字 典 ， 字 典 的 键 
是 补丁 的 属性 。 


np.random.seed(1234) 

fig, ax = plt.subplots(1) 

x = 30*np.random. randn( 10000) 

mu = x.mean() 

median = np.median(x) 

Sigma = x.std() 

textstr = '$\mu=%.2F$\n$\mathrm{median }=%. 2F$\n$\sigma=%. 2F$'%(m 
u, median, sigma) 


ax.hist(x, 50) 
# these are matplotlib.patch.Patch properties 
props = dict(boxstyle='round', facecolor='wheat', alpha=0.5) 


# place a text box in upper left in axes coords 
ax.text(0.05, 0.95, textstr, transform=ax.transAxes, fontsize=14 


I 


verticalalignment='top', bbox=props) 
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